MiniMax H3 API

curl 'https://minimaxh3.studio/api/v1/video/generations' \
  -H "Authorization: Bearer $MINIMAXH3_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: my-video-001' \
  --data '{"model":"minimax-h3","mode":"text-to-video","prompt":"A ceramic cup in soft morning light, slow camera push-in.","duration":5,"resolution":"768p","aspect_ratio":"16:9","max_credits":175}'

curl 'https://minimaxh3.studio/api/v1/tasks/YOUR_TASK_ID' \
  -H "Authorization: Bearer $MINIMAXH3_API_KEY"

{
  "id": "idem_example",
  "status": "completed",
  "model": "minimax-h3",
  "mode": "text-to-video",
  "credits_used": 175,
  "credits_refunded": 0,
  "billing_status": "settled",
  "output": {
    "video_url": "https://your-managed-storage.example/video.mp4"
  },
  "error": null
}

{
  "model": "minimax-h3",
  "mode": "media-to-video",
  "prompt": "Follow the reference motion.",
  "duration": 5,
  "resolution": "768p",
  "reference_image_urls": [
    "https://example.com/subject.png"
  ],
  "reference_video_urls": [
    "https://example.com/motion.mp4"
  ],
  "reference_video_durations": [
    3
  ],
  "max_credits": 280
}

import os, time, requests
headers = {"Authorization": "Bearer " + os.environ["MINIMAXH3_API_KEY"]}
# Save the ID returned by POST; this example only polls that job.
task_id = os.environ["MINIMAXH3_TASK_ID"]
for _ in range(360):
    r = requests.get("https://minimaxh3.studio/api/v1/tasks/" + task_id, headers=headers, timeout=65)
    if r.status_code == 429:
        time.sleep(int(r.headers.get("Retry-After", "10")))
        continue
    r.raise_for_status()
    task = r.json()
    if task["status"] != "processing":
        print(task)
        break
    time.sleep(10)
else:
    print("Still processing; save the task ID and query it later.")

const taskId = process.env.MINIMAXH3_TASK_ID;
const headers = { Authorization: 'Bearer ' + process.env.MINIMAXH3_API_KEY };
const response = await fetch('https://minimaxh3.studio/api/v1/tasks/' + encodeURIComponent(taskId), {
  headers, signal: AbortSignal.timeout(65000)
});
if (!response.ok) throw new Error('Query failed: ' + response.status);
console.log(await response.json());
// Poll no faster than every 10s. Respect Retry-After on HTTP 429.