API

MiniMax H3 Image API

Imagem

Gere e edite imagens com a API do MiniMax H3 Image. Crie uma imagem por requisição em 1K, 2K ou 4K e use até 16 referências para orientar a edição ou a composição.

Autorizações

Bearerstringheaderobrigatório

Chave de API para autorizar solicitações

Corpo

application/json
modelstringobrigatório
minimax-h3-image
input.promptstringobrigatório

Descreva a imagem que deseja criar ou as alterações necessárias. Na edição, indique o que deve mudar e quais detalhes preservar. Espaços no início e no fim são removidos.

input.imagesstring[]opcional

Lista opcional de até 16 URLs HTTPS de imagens acessíveis publicamente. Adicione referências para editar ou combinar imagens; omita o campo para gerar a partir de texto.

Envie strings de URL, não arquivos nem dados base64. O alias image_urls também é aceito; use apenas um dos dois campos.

Máximo de URLs: 16.

Exemplo: ["https://example.com/product.png"]

input.aspect_ratiostringopcional

Proporção entre largura e altura da imagem. O padrão é auto. Escolha uma das proporções listadas para definir a composição.

Padrão: auto

auto1:116:99:163:22:33:44:321:9
input.resolutionstringopcional

Resolução de saída: 1k, 2k ou 4k. O padrão é 2k. Maiúsculas e minúsculas são aceitas e normalizadas antes da cobrança e da geração.

Padrão: 2k

1k2k4k

Exemplos de requisição

Omita images para gerar a partir de texto ou adicione URLs HTTPS públicas para editar com referências. Substitua as URLs de example.com antes de enviar. Cada requisição cria uma imagem. Salve data.task_id e consulte POST /api/v1/check até o status ser completed ou failed.

POST /api/v1/create
curl -X POST https://nanobanana.io/api/v1/create \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax-h3-image",
  "input": {
    "prompt": "Uma foto de produto cinematográfica de uma câmera futurista em formato de banana",
    "aspect_ratio": "1:1",
    "resolution": "2k"
  }
}'
POST /api/v1/create · HTTP 201
{
  "data": {
    "task_id": "task_example",
    "model": "minimax-h3-image",
    "status": "processing",
    "credits": 10
  }
}

Consulte este endpoint usando o ID da tarefa retornado até que a tarefa seja concluída ou falhe. Recomendamos consultar a cada 5 segundos para verificar o status mais recente.

POST /api/v1/check
{
  "task_id": "task_example"
}

Resposta

Status da tarefa retornado por POST /api/v1/check. Os IDs, URLs e horários abaixo são ilustrativos.

idstringobrigatório

Identificador da tarefa em data.id, igual ao task_id enviado na consulta.

statusstringobrigatório
completed indica que a geração foi bem-sucedida e data.data contém os resultados. Nos demais status, data.data é null.
failed_reasonstringopcional

Retornado somente quando status é failed, para explicar a falha. O campo é omitido em completed e processing.

Concluída · completed

Os URLs de download estão em data.data.results.

POST /api/v1/check · HTTP 200
{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "minimax-h3-image",
    "status": "completed",
    "data": {
      "results": [
        "https://example.com/generated.png"
      ],
      "processing_time": 18
    }
  }
}

Outros status

Em processing ou failed, data.data é null. Este exemplo mostra failed: somente failed inclui failed_reason. Continue consultando em processing; pare em failed.

POST /api/v1/check · HTTP 200
{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "minimax-h3-image",
    "status": "failed",
    "data": null,
    "failed_reason": "Generation failed."
  }
}

Consumo de créditos

Créditos consumidos por uma solicitação que gera uma imagem.

Créditos consumidos por uma solicitação que gera uma imagem.
Resolução1K2K4K
Uma imagem101030

Sem parâmetros opcionais: 10 créditos

Envie explicitamente os parâmetros input indicados para usar a tarifa correspondente. Solicitações que geram várias imagens podem consumir mais créditos.

O campo credits retornado por POST /api/v1/create mostra os créditos cobrados pela tarefa.