MiniMax-H3 API

Verwenden Sie die genaue Modell-ID MiniMax-H3. Das Modellfeld muss genau mit dieser Seite übereinstimmen.

BeispielausgabeMiniMax-H3POST /v1/videos5.2s

Parameter: duration=5resolution=2Kratio=16:9

Prompt: A fleet of hot-air balloons drifts over mist-filled mountain valleys at dawn. Aerial camera glides slowly between the balloons as golden light breaks over the ridges and fog rolls through the pines below. Calm, majestic, photoreal landscape, steady motion, no text.

Anfrage, die dieses Beispiel erstellt hat

{
  "model": "MiniMax-H3",
  "prompt": "A fleet of hot-air balloons drifts over mist-filled mountain valleys at dawn. Aerial camera glides slowly between the balloons as golden light breaks over the ridges and fog rolls through the pines below. Calm, majestic, photoreal landscape, steady motion, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "2K",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

Authentifizierung und Endpunkt

Verwenden Sie einen Modelflare-API-Schlüssel mit https://modelflare.dev/v1. Der Gateway-Einstiegspunkt ist POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Erstellen Sie eine Aufgabe

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [{"type": "text", "text": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"}],
    "resolution": "2K", "duration": 5, "ratio": "16:9"
  }'

Umfrage und Download

Speichern Sie die Aufgaben-ID. Abfrage GET /v1/videos/{task_id} und Download mit GET /v1/videos/{task_id}/content. Ergebnis-URLs können ablaufen. Übertragen Sie die Datei daher umgehend.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Notizen anfordern

MiniMax-H3 verwendet content[], wobei resolution, duration und ratio die Ausgabe steuern.

Parameter anfordern

MiniMax-H3 verwendet ein multimodales content[]-Array. Fragen Sie den MiniMax-Abfragepfad nach der Aufgabenerstellung ab. Die Rollen first_frame/last_frame und reference_* sind unterschiedliche Arbeitsabläufe.

Feld	Erforderlich	Notizen
model	Ja	MiniMax-H3
content[]	Ja	Genau ein text-Element; kann first_frame, last_frame, reference_image, reference_video oder reference_audio umfassen.
resolution	Ja	768P / 2K
duration	Ja	4–15 Sekunden
ratio	Bedingt	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
content[].role	Bedingt	Verwenden Sie first_frame / last_frame für Bild-zu-Video und reference_* für Referenz-Workflows; Mischen Sie die Gruppen nicht
content[].url	Nein	Öffentliche HTTP/HTTPS-URL erforderlich; Base64-Medien werden nicht unterstützt
aigc_watermark	Nein	Ob ein Wasserzeichen hinzugefügt werden soll
callback_url	Nein	Rückruf-URL für den Aufgabenstatus

Eingabe- und Ausgabegrenzen

Die Ausgabe erfolgt 4–15 Sekunden lang in 768P oder 2K. Nur-Text-Anfragen benötigen einen konkreten ratio; Bild-zu-Video ermöglicht ein erstes und ein letztes Bild, während Referenz-Workflows mindestens ein Referenzbild oder -video erfordern und nicht nur Audio verwenden können. Vermischen Sie die beiden Rollengruppen nicht.

Dokumentierte Workflow-Beispiele

MiniMax-H3 Medien-URLs müssen öffentlich zugänglich sein und dürfen Base64 nicht verwenden; Erst-/Endbild- und Referenz-Workflows dürfen nicht gemischt werden.

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [
      {"type": "text", "text": "让图像主体沿视频动作自然移动"},
      {"type": "reference_image", "role": "reference_image", "url": "https://example.com/subject.png"},
      {"type": "reference_video", "role": "reference_video", "url": "https://example.com/motion.mp4"}
    ],
    "resolution": "2K", "duration": 5, "ratio": "16:9"
  }'

Fehler und fehlgeschlagene Aufgaben

Ungültige Modellparameter geben ein 4xx mit einer Anforderungs-ID zurück. Eine asynchrone Aufgabe kann auch nach erfolgreicher Erstellung als fehlgeschlagen gelten. Verwenden Sie error_code und error_message aus der Umfrageantwort als letzten Aufgabengrund. Wiederholen Sie dieselbe Anfrage nicht mit einer anderen JSON-Form.

Unterstützter Bereich

Auf dieser Seite werden Modelflare-Modellgenerierungs- und -bearbeitungsaufrufe behandelt. Such- oder Kartenanreicherung, Sprachverwaltung und Elementbibliotheksverwaltung sind Ressourcen-APIs außerhalb dieser öffentlichen Modellaufrufoberfläche und keine erforderlichen Anforderungsfelder.

Preise und Abrechnung

Dieses Modell verwendet eine Videoabrechnung pro Sekunde. Den aktuellen Kundenpreis, den Referenzlistenpreis und die vollständige Spezifikation finden Sie auf der Modellpreisseite.

Hinweis

Diese Seite dokumentiert die öffentliche Schnittstelle von Modelflare. Bei den hier dargestellten Feldern und Grenzen handelt es sich um den aktuellen Vertrag.

Varianten

Modell-ID	Unterschied
MiniMax-H3	Das auf dieser Seite dokumentierte Modell.