API de geração de vídeo MiniMax-H3
Crie tarefas assíncronas de vídeo MiniMax-H3 no APIMaster, consulte o status e baixe o MP4.
Geração de vídeo MiniMax-H3
Use MiniMax-H3 pela API de vídeo compatível com OpenAI do APIMaster. A geração é assíncrona.
URL base:
https://apimaster.ai/v1éhttps://apimaster.ai/v1. Crie tarefas comPOST https://apimaster.ai/v1/video/generations.
Compatibilidade e validação
São aceites POST https://apimaster.ai/v1/video/generations e POST https://apimaster.ai/v1/videos/generations. Para o mesmo modelo, os parâmetros e a cobrança são idênticos; cada rota mantém o formato anterior da resposta de criação. Os clientes existentes podem manter a sua rota.
MiniMax-H3 mantém o exemplo no singular; size e resolution, assim como ratio e aspect_ratio, são aliases. Valores não suportados ou aliases em conflito retornam HTTP 400, sem mudar silenciosamente para uma resolução superior. Indique resolução, proporção e duração explicitamente.
Criar uma tarefa
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
model |
string | sim | MiniMax-H3 |
prompt |
string | condicional | Descrição do vídeo |
duration |
integer | não | 4–15 segundos, padrão 4 |
size |
string | não | 768P ou 2K, padrão 768P |
ratio |
string | não | Proporção, padrão 16:9 |
curl -s "https://apimaster.ai/v1/video/generations" \
-H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"model":"MiniMax-H3","prompt":"A calm ocean at sunrise, cinematic wide shot","duration":4,"size":"768P","ratio":"16:9"}'
A resposta retorna id e task_id imediatamente, com status queued.
Consultar o status
GET https://apimaster.ai/v1/videos/{task_id} retorna queued, in_progress, completed ou failed.
curl -s "https://apimaster.ai/v1/videos/task_xxxxxxxx" -H "Authorization: Bearer YOUR_API_KEY"
Aguarde 10–20 segundos após o envio e consulte a cada 3–5 segundos.
Baixar o vídeo
curl -L "https://apimaster.ai/v1/videos/task_xxxxxxxx/content" \
-H "Authorization: Bearer YOUR_API_KEY" -o output.mp4
Baixe o MP4 quando o status for completed. duration aceita 4–15 segundos e size aceita 768P e 2K.
Vídeo a partir de referências (r2v)
Envie o array V2 oficial content ao endpoint APIMaster acima. É obrigatório um elemento text não vazio; com content, não é necessário prompt no nível superior. reference_image orienta o tema ou estilo, sem fixar o primeiro quadro. O campo anterior images mapeia as duas primeiras imagens para os quadros inicial e final. Não misture esses papéis com referências.
{
"model": "MiniMax-H3",
"content": [
{"type": "text", "text": "Use the character in Image 1 as the subject, walking through a garden."},
{"type": "image_url", "image_url": {"url": "https://YOUR_PUBLIC_IMAGE_URL/reference.jpg"}, "role": "reference_image"}
],
"resolution": "768P",
"duration": 4,
"ratio": "16:9"
}
