MiniMax H3 Image API
MiniMax H3 Image é o modelo de geração e edição de imagens da MiniMax, lançado em 11 de novembro de 2026. Na APIMart, você o chama com o ID de modelo minimax-h3-image para texto para imagem e edição com imagens de referência em 1K, 2K ou 4K.
Destaques do Serviço
- Descontos Oficiais
- Pagamento conforme uso
- Rápido e baixa latência
Image link valid for 72 hours
Preços da MiniMax H3 Image API
Preços transparentes sem taxas ocultas. Pague apenas pelo que usar.
| Variante | Nível | Preço OuroPreço atual | Preço Platina | Preço Diamante | Preço oficial | Sua economia |
|---|---|---|---|---|---|---|
minimax-h3-imageOs preços são estimativas; o custo real é cobrado por tokens. | 1K/2K | 0.1891Credits/img~$0.0189/img | 0.1797Credits/img~$0.018/img | 0.1702Credits/img~$0.017/img | 0.2364Credits/img~$0.0236/img | 20% |
| 4K | 0.628Credits/img~$0.0628/img | 0.5966Credits/img~$0.0597/img | 0.5652Credits/img~$0.0565/img | 0.785Credits/img~$0.0785/img | 20% |
* Os custos reais dependem da saída final.
* Cobrança por tokens. As linhas são estimativas de texto para imagem para uma única imagem: a saída de imagem mais cerca de 2.000 tokens de entrada de texto do aprimoramento de prompt. Imagens de referência adicionam tokens de entrada de imagem. O campo cost de cada tarefa mostra o valor realmente cobrado.
MiniMax H3 Image API: texto para imagem e edição de imagem em até 4K
Gere imagens a partir de um prompt ou edite com até 16 imagens de referência. Escolha 1K, 2K ou 4K com qualquer proporção de 1:3 a 3:1, ou defina pixels exatos até 20 milhões. Uma requisição retorna até 10 imagens, e o aprimoramento de prompt integrado expande prompts curtos para você.
MiniMax H3 Image API: exemplo de texto para imagem e edição de imagem
Chame o MiniMax H3 Image na APIMart com uma única requisição POST. A geração é assíncrona: envie uma tarefa e depois consulte o endpoint de tarefas para obter as URLs das imagens.
- 1
Autentique as requisições à MiniMax H3 Image API
Salve sua key da APIMart na variável de ambiente APIMART_API_KEY e envie-a como Authorization: Bearer <key> em todas as requisições.
- 2
Envie uma tarefa do MiniMax H3 Image
Envie POST /v1/images/generations com model minimax-h3-image, seu prompt, size e resolution. Adicione image_urls para editar com imagens de referência. O ID da tarefa está em data[0].task_id.
- 3
Obtenha as imagens geradas
Consulte GET /v1/tasks/{task_id} a cada 3 a 5 segundos até status ser completed e então leia as URLs das imagens em data.result.images[0].url. Os resultados ficam guardados por 72 horas, então baixe-os a tempo.
Consulte a documentação da MiniMax H3 Image API para ver todos os parâmetros, regras de tamanho e campos de resposta.
curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-image",
"prompt": "Uma cafeteria aconchegante à beira-mar ao pôr do sol, fotorrealista, tons quentes",
"size": "16:9",
"resolution": "2K"
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "minimax-h3-image",
"prompt": "Uma cafeteria aconchegante à beira-mar ao pôr do sol, fotorrealista, tons quentes",
"size": "16:9",
"resolution": "2K"
}
resp = requests.post(f"{API_BASE}/v1/images/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["images"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(3)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-image",
"prompt": "Vista a pessoa da primeira imagem com a jaqueta da segunda imagem e mantenha o fundo inalterado",
"image_urls": [
"https://example.com/person.jpg",
"https://example.com/jacket.png"
],
"resolution": "2K"
}'TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"Parâmetros da MiniMax H3 Image API
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
model | string | Sim | Padrão: minimax-h3-image | Use minimax-h3-image. |
prompt | string | Sim | Padrão: — | Descrição da imagem, de 1 a 32.000 caracteres depois de removidos os espaços do início e do fim. |
size | string | Opcional | Padrão: auto | auto, uma proporção como 16:9 (1:3 a 3:1) ou pixels como 2048x1152 (655.360 a 20.000.000 pixels no total). |
aspect_ratio | string | Opcional | Padrão: — | Outra forma de enviar a proporção, por exemplo 16:9. Se definido, substitui size. |
resolution | string | Opcional | Padrão: 4K | 1K, 2K ou 4K. Não pode ser usado quando size está em pixels. |
n | integer | Opcional | Padrão: 1 | Número de imagens, de 1 a 10. |
image_urls | string[] | Opcional | Padrão: — | Até 16 imagens de referência como URLs ou data URIs em Base64. Ao adicioná-las, a requisição passa para o modo de edição. |
prompt_optimizer | boolean | Opcional | Padrão: true | Expande o prompt antes de gerar. false funciona apenas em texto para imagem com tamanho explícito. |
output_format | string | Opcional | Padrão: jpeg | jpeg, png ou webp. |
output_compression | integer | Opcional | Padrão: 95 | Qualidade de compressão de 0 a 100. Ignorado para png. |
watermark | boolean | Opcional | Padrão: false | Adiciona à imagem uma marca-d'água visível de conteúdo gerado por IA. |
