Resumo rápido
A API do MiniMax-H3 executa o MiniMax-H3 Turbo e mais 1 variante pela Mage em POST https://api.mage.space/v1/minimax_h3/generate. Uma solicitação com as configurações padrão custa 30 Gems (cerca de US$ 0,03), sem assinatura. O MiniMax-H3 usa personagens, referências e referências de áudio salvos por meio do @handle no prompt.
Vídeo
Saída
2
Variantes
30
Gems por clipe, padrão
$0.03
Aproximadamente, em USD
Visão geral
O que a API do MiniMax-H3 faz
Um modelo de vídeo aberto e rápido que gera imagem e áudio estéreo juntos. Quadros inicial e final ou até 8 referências (clipes mais longos aceitam menos), de 5 a 15 segundos em até 768p.
Um modelo de vídeo aberto e rápido que gera vídeo e áudio estéreo juntos.
Aceita first_image, last_image, image, additional_images, videos como entrada.
Início rápido
Chame a API do MiniMax-H3
Defina MAGE_API_KEY, envie para /minimax_h3/generate e consulte o status_url até a solicitação ser concluída.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/minimax_h3/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "5",
"model_id": "minimax-h3-turbo"
}' | 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', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '5',
model_id: 'minimax-h3-turbo',
});
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", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "5",
"model_id": "minimax-h3-turbo",
})
print(request["result"]["url"])Modelos
Valores de model_id do MiniMax-H3
Envie model_id para escolher uma variante. Uma solicitação sem ele usa a padrão.
| model_id | Nome | Padrão |
|---|---|---|
| minimax-h3-turbo | MiniMax-H3 Turbo | Sim |
| minimax-h3 | MiniMax-H3 |
Opções
Parâmetros do MiniMax-H3
Valores permitidos em todas as variantes; uma variante pode oferecer menos. A documentação lista as opções de cada variante.
| Campo | Valores |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 480p, 544p, 720p, 768p |
| duration | 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
Entradas
Entradas de mídia aceitas pelo MiniMax-H3
Envie cada uma como URL https, data URL ou upload de até 100 MB.
| Campo | Função |
|---|---|
| first_image | A imagem do primeiro frame. |
| last_image | A imagem do último frame. |
| image | A imagem de referência. |
| additional_images | Imagens de referência adicionais. |
| videos | Os vídeos de origem. |
Regras
O que a API do MiniMax-H3 exige
- Primeiro e último quadros não podem ser combinados com imagens ou vídeos de referência: envie apenas um tipo ou o outro.
- Até 9 imagens de referência e 3 vídeos de referência de 2 a 15 segundos cada.
- As referências compartilham com o clipe um limite de 21 segundos: `duration`, mais 2 segundos para cada imagem de referência, personagem mencionado e referência mencionada, mais 1,15 segundo para cada segundo de cada vídeo de referência (contado até `duration`), deve somar no máximo 21.
Mais modelos de vídeo
Outras APIs de geração de vídeo no Mage
Vídeo · a partir de 338 Gems
API do Plum
Som em todos os clipes, até 2K
Vídeo · a partir de 360 Gems
API do Raspberry
Personagens ganham vida a partir de um primeiro frame
Vídeo · a partir de 40 Gems
API do Wan Video v2.2
Vídeo com pesos abertos e uma variante Lightning
Vídeo · a partir de 189 Gems
API do Berry
Vídeo fiel às suas referências
Vídeo · a partir de 360 Gems
API do Blueberry
Fixe o primeiro e o último frame
Vídeo · a partir de 618 Gems
API do Cherry
Nossa família de vídeos principal
Perguntas frequentes
Perguntas frequentes
Quanto custa a API do MiniMax-H3?
Uma solicitação do MiniMax-H3 com as configurações padrão (MiniMax-H3 Turbo) custa 30 Gems, cerca de US$ 0,03. 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 da Mage não é.
Qual é o endpoint da API do MiniMax-H3?
POST https://api.mage.space/v1/minimax_h3/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 posso chamar?
minimax-h3-turbo (MiniMax-H3 Turbo), minimax-h3 (MiniMax-H3). O padrão é o MiniMax-H3 Turbo.
O MiniMax-H3 aceita imagens de referência ou personagens?
O MiniMax-H3 aceita first_image, last_image, image, additional_images, videos. O MiniMax-H3 usa personagens, referências e referências de áudio salvos por meio do @handle no prompt.
Posso usar o MiniMax-H3 no Claude ou no ChatGPT?
Sim. Conecte o servidor MCP da Mage ao Claude, ChatGPT, Claude Code, Grok ou Cursor e peça o MiniMax-H3 pelo nome. Seu assistente lê as opções com get_model e informa o preço antes de gerar.
Por quanto tempo os resultados do MiniMax-H3 são mantidos?
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.