API di generazione video MiniMax-H3
Crea attività video MiniMax-H3 asincrone con APIMaster, controlla lo stato e scarica il file MP4.
Generazione video MiniMax-H3
Usa MiniMax-H3 tramite l’API video compatibile con OpenAI di APIMaster. La generazione è asincrona.
Base URL:
https://apimaster.ai/v1èhttps://apimaster.ai/v1. Crea un’attività conPOST https://apimaster.ai/v1/video/generations.
Compatibilità e validazione
Sono supportati POST https://apimaster.ai/v1/video/generations e POST https://apimaster.ai/v1/videos/generations. Per lo stesso modello, parametri e fatturazione sono identici; ogni endpoint conserva il formato della risposta di creazione. I client esistenti possono mantenere il percorso attuale.
MiniMax-H3 mantiene l’esempio al singolare; size e resolution, come ratio e aspect_ratio, sono alias. Valori non supportati o alias in conflitto restituiscono HTTP 400, senza passare a una risoluzione superiore. Specificare risoluzione, proporzioni e durata.
Creare un’attività
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
model |
string | sì | MiniMax-H3 |
prompt |
string | condizionale | Descrizione del video |
duration |
integer | no | 4–15 secondi, predefinito 4 |
size |
string | no | 768P o 2K, predefinito 768P |
ratio |
string | no | Proporzioni, predefinito 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"}'
La risposta restituisce subito id e task_id, con stato queued.
Controllare lo stato
GET https://apimaster.ai/v1/videos/{task_id} restituisce queued, in_progress, completed oppure failed.
curl -s "https://apimaster.ai/v1/videos/task_xxxxxxxx" -H "Authorization: Bearer YOUR_API_KEY"
Attendi 10–20 secondi dopo l’invio, quindi controlla ogni 3–5 secondi.
Scaricare il video
curl -L "https://apimaster.ai/v1/videos/task_xxxxxxxx/content" \
-H "Authorization: Bearer YOUR_API_KEY" -o output.mp4
Scarica l’MP4 quando lo stato è completed. duration supporta 4–15 secondi e size supporta 768P e 2K.
Video da riferimenti (r2v)
Invia l’array V2 ufficiale content all’endpoint APIMaster sopra. È necessario un elemento text non vuoto; con content non serve prompt al livello superiore. reference_image guida soggetto o stile senza fissare il primo fotogramma. Il campo precedente images associa le prime due immagini ai fotogrammi iniziale e finale. Non mescolare questi ruoli con i riferimenti.
{
"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"
}
