API MiniMax H3 Image
Referência completa da API dos modelos MiniMax H3 Image de geração de imagens a partir de texto e edição de imagens.
Variantes do modelo
Esta API oferece suporte a duas variantes do modelo:
Comparação rápida
Proporções compatíveis
1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9
Forneça a proporção como valores numéricos separados de width e height, e não como dimensões em pixels. Se ambos os valores forem omitidos, a proporção padrão será 1:1; caso contrário, forneça ambos os valores usando um dos pares de números inteiros compatíveis.
MiniMax H3 Image (Texto para imagem)
Ponto de extremidade
POST /api/v1/image/task
Autenticação
Authorization: Bearer YOUR_API_KEY
Parâmetros da solicitação
Obrigatórios
Opcionais
Observação: A proporção width:height deve ser uma das 15 proporções compatíveis listadas acima.
Exemplo de solicitação
javascript
MiniMax H3 Image Edit (Edição de imagens)
Ponto de extremidade
POST /api/v1/image/task
Parâmetros da solicitação
Obrigatórios
Opcionais
Observação: A proporção width:height deve ser uma das 15 proporções compatíveis listadas acima.
Exemplo de solicitação
javascript
Exemplo de edição de uma única imagem
javascript
Exemplo de composição com várias imagens
javascript
Formato da resposta
Resposta inicial
json
Resposta à consulta periódica
Consulte periodicamente GET /api/v1/image/{task_id} para verificar o status. As respostas bem-sucedidas dessas consultas fornecem as URLs das imagens geradas em data.task_result.images[].url.
Valores de status
submitted: Tarefa aceitaprocessing: Geração de imagem em andamentosucceed: Geração de imagem concluídafailed: Falha na geração de imagem
Boas práticas
- Prompts detalhados: Descreva o tema, a iluminação e a composição, mantendo os prompts dentro de 5000 caracteres
- Seleção da resolução: Informe explicitamente
1k,2kou4kem cada solicitação - Proporção: Use valores de proporção emparelhados para
widtheheight, ou omita ambos para obter1:1 - Qualidade da edição: Forneça 1-16 imagens de referência que atendam aos requisitos de formato e dimensões compatíveis