Pular para o conteúdo
PlaygroundDocumentaçãoObter chave de API

API do Mage · Modelo de imagem

API do MiniMax H3 Image

Imagens nativas de 16 megapixels, pesos abertos

Obter uma chave de APITeste o MiniMax H3 Image no playground
POST https://api.mage.space/v1/minimax_h3_image/generate

Resumo rápido

A API do MiniMax H3 Image executa o MiniMax H3 Image pelo Mage em POST https://api.mage.space/v1/minimax_h3_image/generate. Uma requisição com as configurações padrão custa 15 Gems (cerca de US$ 0,015), sem assinatura. O MiniMax H3 Image aceita personagens salvos e referências por @handle no prompt.

  • ImagemSaída
  • 1Variante
  • 15Gems por imagem, padrão
  • $0.015Aproximadamente, em USD

Visão geral

O que a API do MiniMax H3 Image faz

Um modelo de imagem de pesos abertos que gera até 4K (cerca de 16 megapixels) com muitos detalhes e seguindo as instruções com precisão. Edite ou combine até 16 imagens de referência, com LoRAs.

Um modelo de imagem de pesos abertos para texto para imagem e edições a partir de até 16 imagens de referência, em 2K (cerca de 4 megapixels) ou 4K nativo (cerca de 16 megapixels), com LoRAs. Destilado em seis passos, ele não aceita prompt negativo, número de passos nem escala de guidance. Escreva a imagem inteira em inglês; para uma edição, diga o que manter de cada imagem, o que muda e depois descreva o resultado.

Aceita image e additional_images como entradas.

Início rápido

Chame a API do MiniMax H3 Image

Defina MAGE_API_KEY, envie para /minimax_h3_image/generate e consulte status_url até a requisição ser concluída.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/minimax_h3_image/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "minimax-h3-image"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('minimax_h3_image', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'minimax-h3-image',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("minimax_h3_image", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "minimax-h3-image",
})

print(request["result"]["url"])

Modelos

Valores de model_id do MiniMax H3 Image

Envie model_id para escolher uma variante. Uma solicitação sem ele usa a padrão.

model_idNomePadrão
minimax-h3-imageMiniMax H3 ImageSim

Opções

Parâmetros do MiniMax H3 Image

Valores permitidos em todas as variantes; uma variante pode oferecer menos. A documentação lista as opções de cada variante.

CampoValores
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution2k, 4k

Entradas

Entradas de mídia aceitas pelo MiniMax H3 Image

Envie cada uma como URL https, data URL ou upload de até 100 MB.

CampoFunção
imageA imagem de referência.
additional_imagesImagens de referência adicionais.

Regras

O que a API do MiniMax H3 Image impõe

  • Envie até 16 imagens de referência entre image e additional_images, além dos personagens e referências mencionados; o prompt os chama de imagem 1, imagem 2, ... nessa ordem.

Mais modelos de imagem

Outras APIs de geração de imagens no Mage

Perguntas frequentes

Perguntas frequentes

Quanto custa a API do MiniMax H3 Image?
Uma requisição do MiniMax H3 Image com as configurações padrão (MiniMax H3 Image) custa 15 Gems, cerca de US$ 0,015. Outras resoluções, durações e variantes alteram o preço; a resposta informa o valor exato cobrado. Uma geração que falha é reembolsada; uma bloqueada pela política de conteúdo do Mage não é.
Qual é o endpoint da API do MiniMax H3 Image?
POST https://api.mage.space/v1/minimax_h3_image/generate com um cabeçalho Authorization: Bearer contendo sua chave de API da Mage. A resposta inclui um status_url para consultar o resultado.
Quais modelos do MiniMax H3 Image posso chamar?
minimax-h3-image (MiniMax H3 Image). O padrão é o MiniMax H3 Image.
O MiniMax H3 Image aceita imagens de referência ou personagens?
O MiniMax H3 Image aceita image, additional_images. O MiniMax H3 Image aceita personagens salvos e referências por @handle no prompt.
Posso usar o MiniMax H3 Image pelo Claude ou pelo ChatGPT?
Sim. Conecte o servidor MCP do Mage ao Claude, ChatGPT, Claude Code, Grok ou Cursor e peça o MiniMax H3 Image pelo nome. Seu assistente lê as opções dele com get_model e informa o preço antes de gerar.
Por quanto tempo os resultados do MiniMax H3 Image ficam guardados?
Resultados e entradas ficam salvos por 30 dias. Baixe o que quiser guardar para o seu próprio armazenamento.

Comece a criar com o Mage

Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.

Obter uma chave de APITeste o MiniMax H3 Image no playground