21:9 高调光晕宽幅：左侧留白，右侧悬浮半透明玻璃渲染面板与光带轨道，冷蓝、珊瑚粉与暖金渐变，模型名以玻璃蚀刻发光立体字呈现。

Muse Image 1.0

muse-image-1.0/text-to-image

Modelo de geração e edição de imagens baseado em raciocínio da Meta, que primeiro decompõe prompts complexos e depois renderiza, podendo combinar várias imagens de referência e usar a busca na web para garantir precisão factual

muse-image-1.0/image-to-image muse-image-1.0/text-to-image

Experimentar muse-image-1.0/text-to-image

Entrada

Criações

Ver todas as criações

Saída

image

Preencha os parâmetros e gere — os resultados aparecerão aqui.

Preços

muse-image-1.0/text-to-image per task

Preço unitário	$0.015

Visão geral da posição

muse-image-1.0/text-to-image é a rota puramente textual no HiAPI.ai do modelo de texto para imagem lançado pela Meta, adotando um fluxo de geração de raciocínio primeiro, renderização depois: antes de gerar a imagem, decompõe prompts de múltiplos parágrafos, planeja o layout da cena e se autocorrige durante o processo de raciocínio. É adequado para desenvolvedores que precisam de geração em lote de alta concorrência e com prompts mais complexos, como variantes de materiais publicitários, imagens de catálogo de produtos, etc. Por meio da interface unificada do HiAPI.ai, basta um prompt de texto para gerar imagens, com proporção e formato de saída selecionáveis.

Destaques principais

Raciocínio antes da renderização, prompts complexos mais controláveis — antes da renderização, decompõe prompts de múltiplos parágrafos na cadeia de raciocínio, planeja o layout e corrige iterativamente a saída, sendo mais adequado para descrições estruturadas do que a geração em uma única passagem.
Prompts intensivos em conhecimento podem usar busca na web — ao encontrar prompts que exigem informações do mundo real, aciona a busca na web para calibrar o conteúdo, reduzindo desvios em ilustrações de natureza factual.
Saída de imagem final em uma única chamada, integração simples — basta enviar o prompt de texto para especificar a proporção e o formato de saída jpeg, png ou webp, obtendo diretamente um ativo de imagem pronto para uso.

Descrição das capacidades

Texto para imagem com raciocínio: decompõe prompts complexos de múltiplos parágrafos em elementos visuais executáveis, planeja o layout antes da renderização e se autocorrige, reduzindo o custo de ajustes repetidos no prompt.

Proporções predefinidas: oferece nove proporções — 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9 e 9:21 — que podem ser selecionadas diretamente conforme o posicionamento de mídia ou o layout, sem necessidade de recorte posterior.

Saída em múltiplos formatos: suporta três formatos de download — jpeg, png e webp —, com webp como padrão, facilitando a escolha conforme exibição no front-end, arquivamento ou fluxos de processamento posteriores.

Suporte a prompts longos: limite de 5000 caracteres no prompt, comportando necessidades complexas de geração com múltiplos parágrafos e descrições com restrições.

Cenários de aplicação

Equipes de mídia gerando variantes de anúncios em lote — usar vários conjuntos de prompts de texto com o mesmo argumento de venda para gerar imagens em lote, produzindo materiais em diferentes proporções, diretamente para testes de veiculação em múltiplos canais.
Operações de e-commerce criando imagens de cena de produtos — gerar imagens de cena em diferentes estilos e composições a partir de descrições textuais de produtos, complementando o catálogo e as páginas de detalhes.
Operações de conteúdo ilustrando pautas de conhecimento — inserir descrições de pauta com elementos factuais para produzir ilustrações alinhadas ao conteúdo, usadas em artigos, postagens e publicações em redes sociais.

Limitações e recomendações de seleção

Materiais públicos não divulgam a resolução de saída desta rota; a proporção define apenas o formato, não o tamanho exato em pixels, portanto cenários com requisitos rígidos de resolução precisam de verificação prévia. O fluxo com raciocínio e a busca na web sob demanda trazem latência adicional, não sendo adequados para geração em tempo real com latência extremamente baixa. A saída é limitada a imagens, sem vídeo ou áudio. Se a tarefa exigir fusão ou reescrita com base em uma imagem de referência, deve-se escolher a rota image-to-image da mesma família.

Perguntas frequentes

Ver todas as perguntas →

Como escolher entre geração de imagem a partir de texto e edição de imagem?

Quando você tem apenas texto e vai começar do zero, escolha a geração de imagem a partir de texto; quando precisar manter um sujeito ou layout existente, escolha a edição de imagem e forneça uma imagem de referência.
Quantas imagens posso obter por vez?

Cada tarefa retorna uma imagem, sem opção de quantidade. Se precisar comparar outra composição, ajuste o prompt e envie uma nova tarefa.
Posso escolher 1K, 2K ou 4K?

Esta entrada não oferece níveis de resolução. O enquadramento é escolhido por você e as dimensões em pixels são determinadas pelo modelo, geralmente cerca de 2,5MP; consulte as dimensões reais do arquivo baixado.
Quais formatos de arquivo posso escolher?

Você pode escolher JPEG, PNG ou WebP; se nenhum for selecionado, WebP é usado. Escolha de acordo com as necessidades posteriores de materiais para páginas web ou ferramentas de design.

Criar uma tarefa de geração

POST https://api.hiapi.ai/v1/tasks

Cabeçalhos

AuthorizationstringObrigatório

Chave de API da conta. Obrigatória em toda requisição. Exemplo: Bearer YOUR_HIAPI_API_KEY. Obter chave de API

Content-TypestringOpcional

O corpo da requisição é sempre interpretado como JSON; se enviado, apenas application/json (charset opcional) é aceito — qualquer outro valor retorna 415. Exemplo: application/json.

Idempotency-KeystringOpcional

Chave de idempotência, até 255 bytes. Retries com a mesma chave da mesma conta criam a tarefa apenas uma vez; replays retornam o taskId original.

Chave de idempotência

Em timeouts de rede ou retries automáticos do cliente, a mesma chave cria a tarefa apenas uma vez, sem cobrança duplicada (escopo = a conta da chave de API). Use um identificador de negócio exclusivo (ex.: "order-42"); replays retornam o taskId original e as chaves expiram 24 h após a primeira requisição. A matriz completa de cenários está na introdução da API assíncrona unificada.

Corpo

modelstringObrigatório

Valor fixo atual: muse-image-1.0/text-to-image

routestringOpcional

Valor fixo atual: default

inputobjectObrigatório

Objeto de parâmetros de negócio para muse-image-1.0/text-to-image e a rota default — veja a tabela de parâmetros abaixo.

promptstringObrigatóriominLength 1maxLength 5000

Usado para descrever a imagem que você deseja gerar, ou para explicar o que precisa ser modificado e preservado na imagem de referência; assume a forma de string.

aspect_ratiostringOpcional

Selecione a proporção de aspecto da imagem de saída; assume a forma de string; este item não especifica dimensões exatas em pixels.

Opções:1:14:33:416:99:163:22:321:9

Mostrar tudo (1)

9:21

output_formatstringOpcionalPadrão: "webp"

Selecione o formato de arquivo para baixar a imagem; assume a forma de string; o padrão é webp.

Opções:jpegpngwebp

callbackobjectOpcional

Configuração de notificação de estado terminal. Se omitida, sem callback: consulte a tarefa por conta própria.

Callbacks (Webhook)

Informe callback.url na criação e o HiAPI fará POST no seu serviço no estado terminal, sem polling. O corpo do callback replica a estrutura do detalhe da tarefa; assinatura, retries e idempotência estão descritos na introdução da API assíncrona unificada.

urlstringObrigatório

Obrigatória se callback estiver presente. No estado terminal é enviado um POST para esta URL; deve ser uma URL http(s) válida.

whenstringOpcionalPadrão: "final"

Atualmente só há suporte a final — notifica tanto em success quanto em fail.

Opções:final

storagestringOpcionalPadrão: "temp"

Nível de armazenamento de artefatos: temp (padrão, ~7 dias) ou persistent (longo prazo, cobrado por tamanho). Saldo insuficiente ou limite excedido ⇒ rebaixamento silencioso para temp; o nível efetivo aparece na resposta de detalhes.

Opções:temppersistent

Exemplos de requisição

# Envia uma tarefa assíncrona; retorna um taskId imediatamente (sem esperar a geração)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "muse-image-1.0/text-to-image",
  "input": {
    "prompt": "…",
    "output_format": "webp"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "muse-image-1.0/text-to-image",
    input: {
      "prompt": "…",
      "output_format": "webp"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "muse-image-1.0/text-to-image",
        "input": {
          "prompt": "…",
          "output_format": "webp"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obter detalhes da tarefa

GET https://api.hiapi.ai/v1/tasks/:id

Campos da resposta

taskIdstringObrigatório

ID da tarefa, sempre com prefixo tk-hiapi-.

modelstringObrigatório

Nome completo resolvido do modelo. Tarefas enviadas com o parâmetro route retornam base@route (ex.: gpt-image-2/text-to-image@ext); caso contrário, igual ao nome enviado.

routestringOpcional

Presente apenas se o parâmetro route explícito foi usado; ecoa o valor enviado.

statusstringObrigatório

Estado da tarefa.

Valores de status

queued Na fila, ainda não iniciada. handling Em processamento. archiving Processamento concluído, preparando artefatos. success Terminal: concluído, artefatos disponíveis (retorna output). fail Terminal: falha (retorna error). Após o envio, acompanhe status: success e fail são terminais, os demais não. Faça polling a cada 1–3 s até o estado terminal. Em caso de sucesso, baixe os artefatos em output[].url e transfira antes de expireAt; para retenção longa, use storage: "persistent" na criação.

creatednumberObrigatório

Momento de criação da tarefa (segundos Unix).

completednumberObrigatório

Segundos Unix do estado terminal; 0 enquanto não terminal.

outputarrayOpcional

Presente apenas com status == success. Lista de artefatos — sempre um array; uma tarefa pode retornar vários types ao mesmo tempo (ex.: video + first_frame).

Array [ object ]

Itens do array

urlstringObrigatório

URL do artefato, baixável diretamente.

typestringObrigatório

Valores possíveis no momento: video, image, audio, first_frame, last_frame, thumbnail; poderão ser ampliados.

expireAtnumberObrigatório

Segundos Unix de disponibilidade do artefato; baixe ou transfira antes da expiração.

errorobjectOpcional

Presente apenas com status == fail.

codestringObrigatório

Código de erro de negócio.

messagestringObrigatório

Descrição do erro.

Exemplos de resposta

Sucesso

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Em processamento (não final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Falhou

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}