Meta: Muse Image
Muse Image cria e revê imagens a partir de texto e de referências visuais. Utilize meta/muse-image com o método Images para descrever uma nova composição ou orientar uma alteração com uma imagem existente. Devolve imagens numa resposta completa, sem streaming nativo de imagens indicado para este perfil.
Sobre o modelo
Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo.
Muse Image é o modelo de geração de imagens da Meta, selecionado com o ID exato meta/muse-image. As suas entradas documentadas são texto e imagens e a saída é uma imagem. Utilize o método Images em POST /v1/images/generations para preparar uma descrição escrita de um novo elemento visual ou de uma revisão orientada por referência. O prompt deve indicar o que criar e qual a relação visual importante para o resultado.
Para uma nova composição, descreva o tema, o cenário, a iluminação, a paleta e o ponto de vista. Explique o destino quando este afetar o design, como uma capa horizontal com o sujeito afastado de uma área de texto. Uma descrição de cena pode pedir um recipiente de vidro sobre uma saliência de pedra, um ponto de vista baixo, luz fria da manhã e um fundo discreto. As instruções visuais específicas fornecem detalhes concretos para comparar com a imagem concluída.
Para uma revisão, forneça a imagem relevante através de input_references e identifique a alteração pretendida. A representação de referência documentada aceita um URL de imagem HTTP(S) ou um URL de dados base64. Explique quais os detalhes de origem que devem manter-se na revisão, como a forma do sujeito, o enquadramento ou o tratamento global da cor, e descreva o elemento que deve mudar. Mantenha a fonte e a revisão em conjunto ao decidir se o resultado se adequa à tarefa.
O perfil dedicado do modelo indica entrada de texto e imagem, saída de imagem e ausência de streaming nativo. Utilize a resposta de imagem completa como resultado. Conserve todas as imagens do array data concluído. Para saída b64_json, descodifique os bytes da imagem; para um URL de imagem devolvido, obtenha o ficheiro de imagem real. Utilize media_type devolvido quando estiver disponível e preserve as informações de resposta e de utilização que o acompanham.
Guarde a configuração selecionada com a descrição visual. Após a conclusão, compare os detalhes do sujeito, a composição, a relação com a referência e qualquer texto na imagem com a descrição. Guarde o resultado escolhido, as referências de origem e o prompt, para que uma revisão posterior parta de uma imagem conhecida e de uma alteração explícita.
Ailoot Ultra · Images POST /v1/images/generations meta/muse-image
meta/muse-imageIntrodução
Muse Image cria e revê imagens a partir de texto e de referências visuais. Utilize meta/muse-image com o método Images para descrever uma nova composição ou orientar uma alteração com uma imagem existente. Devolve imagens numa resposta completa, sem streaming nativo de imagens indicado para este perfil.
- Entradas aceites
- Texto · Imagens
- Resultados
- Imagens
Disponível no Ailoot · entradas e métodos
Ailoot Ultra · Images POST /v1/images/generations
- Entrada
text,image- Saída
image- Formato de saída
- Ficheiro de imagem
| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites meta/muse-image | Predefinição— |
Campoprompt | Tipostring | RequisitoObrigatório | Valores e limites | Predefinição— |
Campostream | Tipoboolean | RequisitoOpcional | Valores e limites false | Predefiniçãofalse |
Campoinput_references | Tipoarray | RequisitoOpcional | Valores e limites | Predefinição— |
Parâmetros e ciclo de vida do método
| Parâmetro | Contrato |
|---|---|
Parâmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratomodel, prompt |
Parâmetrooptional | Contratostream, input_references |
Parâmetromaterial_types | Contratotext, image |
Parâmetroconditions | ContratoUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Ciclo de vida: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarifários
Cálculo do custo final
As tarifas apresentadas permitem estimar o custo antes da geração. O montante final cobrado é calculado a partir do custo registado para a geração original. A duração medida do resultado e as quantidades previstas não correspondem à quantidade final faturável.
As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado.
- Modo rápido
- Não especificado Quando o modo rápido está selecionado
- Modo flex
- Não especificado Quando o modo flex está selecionado
- Esforço máximo de raciocínio
- Não especificado Quando o esforço máximo de raciocínio usa o ajuste predefinido (default)
Tarifas estimadas para comparação
Preços por configuração
Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.
| Configuração | Tabela de tarifas | Quantidade prevista | Custo |
|---|---|---|---|
| ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Quantidade prevista— | Custo Entrada · Tokens de entrada · Estimativa apenas para comparação — / 1K tokens Saída · Tokens de saída · Estimativa apenas para comparação — / 1K tokens Entrada · Leitura da cache · Estimativa apenas para comparação — / 1K tokens Entrada · Escrita na cache · Estimativa apenas para comparação — / 1K tokens Entrada · Escrita na cache, 1 hora · Estimativa apenas para comparação — / 1K tokens |
| ConfiguraçãoEstimated generation cost | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Custo Entrada · Custo estimado de geração · Estimativa apenas para comparação $0.98304 estimativa antes da geração This estimate is not an additional charge or a fixed rate for the completed generation. |
O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. Como funcionam a reserva e a liquidação →
Exemplos de pedidos
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "meta/muse-image", "prompt": "A calm studio product photograph with a plain background."}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Receber e guardar os resultados
Ailoot Ultra · Images
Descarregue cada imagem devolvida ou guarde o respetivo conteúdo Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Guardar todos os resultados concluídos
Guarde cada imagem concluída; obtenha cada URL devolvido ou descodifique o respetivo conteúdo Base64.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Se for necessário verificar a resposta original
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Aliases
Aliases do modelo
Ailoot Ultra meta/muse-image
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
FAQ · Meta: Muse Image
- Que entradas e resultados estão disponíveis?
POST /v1/images/generations·meta/muse-image:text,image→image- Que campos utiliza o pedido?
POST /v1/images/generations·meta/muse-image:model,prompt,stream,input_references