MiniMax H3 Image Highspeed

Exemplo rápido

Envie uma solicitação de imagem, salve o id retornado e consulte o status até que a tarefa esteja completed ou failed. Esta API usa tarefas assíncronas e saídas por URL.

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"minimax-h3-image-highspeed","prompt":"An amber bottle on pale limestone in soft morning light","area":"1K","aspect_ratio":"3:2"}'

Endpoint e cabeçalhos

POST https://api.seedrouter.ai/v1/images/generations

Mantenha a chave no seu servidor. Uma resposta HTTP de sucesso confirma o recebimento de uma tarefa; não significa que a imagem esteja pronta.

Parâmetros

São 13 campos aceitos. Apenas model e prompt são obrigatórios. Omita os campos opcionais para usar os valores padrão; nenhum campo aceita null. O Playground oferece o modelo fixo e dez entradas editáveis. O formato de resposta por URL e a entrega de tarefas sem streaming são fixos.

Dependências de tamanho e prompt

Um size explícito deve conter dimensões inteiras positivas com uma área entre 655.360 e 20.000.000 pixels, inclusive. A largura dividida pela altura deve estar entre 1/3 e 3. Por exemplo, 2048x1152 é válido. Ao usar dimensões explícitas, omita tanto aspect_ratio quanto area, mesmo que seu valor fosse auto.

Com o tamanho omitido ou definido como auto, use aspect_ratio e area juntos. A área é um tamanho-alvo; confira o arquivo entregue para saber as dimensões exatas. Ela não representa um preço fixo por imagem.

Definir disable_prompt_enhanced: true exige um tamanho explícito em pixels ou uma proporção fixa. Com o aprimoramento desativado, o modelo lê aproximadamente os primeiros 4.096 tokens do prompt. O limite de envio de 32.000 caracteres continua valendo. A edição sempre aprimora os prompts, portanto true é rejeitado quando images está presente.

Não são aceitos campos de máscara, seed, estilo, qualidade, prompt negativo, fundo ou resolução separada. Parâmetros desconhecidos retornam um erro antes do envio. Esta API não oferece streaming, imagens base64 nem saída WebP.

Imagens de referência

Use URLs HTTP(S) acessíveis publicamente, sem credenciais incorporadas. Cada imagem deve ser JPEG, PNG, WebP, HEIC ou HEIF; ter no máximo 64 MiB; 128–8.192 pixels em cada lado; e uma razão entre o lado maior e o menor de no máximo 4. Mantenha o corpo JSON em até 64 MiB. Os arquivos de imagem são referenciados por URL; seus bytes não são incorporados ao corpo JSON.

Atribua um propósito claro a cada referência e descreva o que deve permanecer inalterado. A ordem do array identifica <Picture 1>, <Picture 2> e assim por diante.

{
  "model": "minimax-h3-image-highspeed",
  "prompt": "Use <Picture 1> as the product and <Picture 2> as the setting. Preserve the product's shape and label. Match the setting's light and perspective.",
  "images": [
    {"image_url": "https://example.com/product.jpg"},
    {"image_url": "https://example.com/setting.jpg"}
  ],
  "aspect_ratio": "3:2",
  "area": "2K",
  "n": 1,
  "output_format": "png"
}

Substitua as URLs ilustrativas pelos seus próprios arquivos de imagem acessíveis.

Cobrança

A cobrança tem três categorias de tokens: entrada de texto, entrada de imagem e saída de imagem. Multiplique o uso real de cada categoria pela tarifa vigente correspondente. A quantidade de saídas, as dimensões das imagens e as imagens de referência afetam o uso; os nomes de resolução não definem uma cobrança fixa. Solicitações que falham não são cobradas. Veja os preços atuais.

Resposta da tarefa e consulta de status

Uma solicitação aceita retorna uma tarefa assíncrona:

{"id":"task_example","model":"minimax-h3-image-highspeed","status":"processing"}

curl https://api.seedrouter.ai/v1/tasks/task_example \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Uma resposta concluída contém URLs de imagens em output.data. Cada imagem entregue inclui seu size e pode incluir revised_prompt (a descrição aprimorada). output.created é o horário de criação em segundos Unix, e output.output_format identifica o formato entregue. output.usage expõe as contagens de tokens de entrada de texto, entrada de imagem e saída de imagem, além da contagem de generated_images entregues. As URLs e os IDs abaixo são ilustrativos:

{
  "id": "task_example",
  "model": "minimax-h3-image-highspeed",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.jpg"}]}
}

Consulte o status a cada 10–20 segundos. Um timeout do cliente não significa que a tarefa falhou: mantenha o ID e continue consultando em vez de enviar uma solicitação duplicada. As respostas públicas não contêm saldos de conta nem custos.

Erros

Erros HTTP usam {"error":{"code":integer,"message":string}}. Uma tarefa que falhou tem status: "failed" e um erro. Corrija parâmetros inválidos antes de um novo envio. Veja o diretório de erros compartilhado e o ciclo de vida da tarefa.

Páginas relacionadas

• Playground e preços do MiniMax H3 Image Highspeed
• MiniMax H3 Image