APIMaster.ai

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à con POST 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"
}