Saltar para o conteúdo principal
POST

Autenticação

string
obrigatório
Todos os endpoints usam Bearer Token. Obtenha sua chave na página de chaves de API.

Sobre os modelos

O MiniMax H3 Image se destaca em fotografia realista, pôsteres, imagens de produto e cenas com texto. Por padrão, ele expande automaticamente o prompt em uma descrição detalhada da cena antes de gerar a imagem. O texto expandido aparece em revised_prompt no resultado da consulta. Para gerar seguindo exatamente o texto original, veja Desativar a otimização do prompt.
Sem resolution, a saída padrão é 4K (cerca de 16 megapixels), com preço unitário cerca de 3,6 vezes o de 1K / 2K. Se não precisar de 4K, envie explicitamente "resolution": "2K".

Parâmetros da solicitação

string
obrigatório
Nome do modelo de geração de imagens, fixo em minimax-h3-image-highspeed.
string
obrigatório
Descrição em texto da imagem a gerar ou editar.Aceita chinês e inglês. Após remover espaços no início e no fim, deve ter de 1 a 32,000 caracteres.
string[]
Array de imagens de referência, no máximo 16. Quando enviado, ativa automaticamente o modo de edição.Cada item pode ser um link direto http(s):// acessível publicamente ou Base64 inline no formato data:image/png;base64,... (a plataforma converte em link antes de enviar ao modelo).Veja Requisitos das imagens de referência.
string
padrão:"auto"
Proporção ou dimensões exatas em pixels da imagem de saída.Valores aceitos:
  • auto: o modelo decide a composição e a proporção com base no prompt
  • Proporção: formato X:Y, com X e Y inteiros de 1 a 300 e proporção entre 1:3 e 3:1 (inclusive), como 1:1, 4:3, 16:9, 9:16, 3:1
  • Pixels exatos: larguraxaltura, como 2048x1152 (também aceita os separadores X, ×, *)
Veja Regras de tamanho.
string
padrão:"4K"
Nível de resolução; junto com a proporção, define os pixels reais da saída.
  • 1K: cerca de 1 megapixel
  • 2K: cerca de 4,2 megapixels
  • 4K (padrão): cerca de 16 megapixels
Também aceita minúsculas.
Quando size usa pixels exatos, não envie resolution; caso contrário, retorna 400.
integer
padrão:"1"
Quantidade de imagens a gerar, de 1 a 10.
boolean
padrão:"true"
Se o prompt deve ser expandido automaticamente.false só vale para texto para imagem e exige um tamanho explícito; veja Desativar a otimização do prompt.
string
padrão:"jpeg"
Formato do arquivo de saída.
  • jpeg (padrão; também aceita jpg)
  • png
  • webp
integer
padrão:"95"
Qualidade de compressão, de 0 a 100. Não se aplica a png.
boolean
padrão:"false"
Se deve adicionar à imagem uma marca d’água visível de conteúdo gerado por IA. Não afeta a identificação implícita nos metadados da imagem.
Os parâmetros a seguir não são suportados e são ignorados se enviados: quality, style, seed, negative_prompt, background, mask_url.Os resultados são sempre retornados como URL; enviar response_format: "b64_json" retorna 400.

Regras de tamanho

Nível + proporção

O nível define a área total e a proporção define o formato: Os pixels reais da saída são arredondados pelo modelo com base na proporção e no nível; considere o valor retornado. Para dimensões exatas, use o formato em pixels.

Pixels exatos

Ao usar size: "larguraxaltura", as seguintes condições devem ser atendidas:
  • ✅ 1024x1024, 2048x1152, 1536x1536, 4000x5000
  • ❌ 512x512 (área pequena demais), 4000x1000 (proporção acima de 3:1), 5000x5000 (acima de 20 megapixels)

Requisitos das imagens de referência

Ao usar URLs, garanta que o link seja acessível publicamente. Se o link não puder ser acessado, a tarefa falha na etapa de geração (status igual a failed, com reembolso integral).No modo de edição, a otimização do prompt fica sempre ativa e não pode ser desativada.

Desativar a otimização do prompt

Por padrão, o modelo expande o prompt antes de gerar a imagem. Para gerar seguindo exatamente o texto original, envie "prompt_optimizer": false, desde que:
  • Seja usado apenas em texto para imagem; com image_urls, retorna 400
  • O tamanho seja explícito: size deve ser uma proporção (como 1:1) ou pixels (como 1024x1024), não auto nem omitido
Com a otimização desativada, o modelo lê apenas cerca dos primeiros 4096 tokens do prompt.

Response

integer
Código de resposta; 200 quando o envio é bem-sucedido.
array
Dados da resposta do envio.

Resposta do envio

Após o envio bem-sucedido, o ID da tarefa assíncrona é retornado imediatamente:

Consultar o resultado da tarefa

Use o task_id da resposta do envio para chamar a API de consulta de tarefas:
A versão rápida gera imagens mais rápido que a padrão (em testes, a versão padrão leva cerca de 10 a 20 segundos por imagem 1K / 2K e cerca de 20 segundos em 4K). Recomendamos consultar a cada 3 a 5 segundos até o status mudar para completed ou failed. Uma tarefa pode rodar por até 600 segundos; defina o timeout de polling do cliente em 10 minutos.

Tarefa concluída

As URLs das imagens ficam em data.result.images[0].url[], com todas as n imagens nesse único array. Baixe e armazene antes de expires_at. Se a tarefa falhar, status será failed, o motivo estará em error.message e o valor será reembolsado integralmente de forma automática.

Exemplos de uso

Texto para imagem (4K padrão)

Texto para imagem (1K + proporção, 4 imagens)

Pixels exatos + PNG

Edição com imagens de referência

Desativar a otimização do prompt