Nutze MiniMax H3 über Rivya Public API v1 mit Model-ID minimax-h3, unterstützten Eingaben, Parametern, Files-API-Regeln, Credits und Response-Beispielen.

Über API verfügbarText oder URL bereit; Referenzmodi nutzen Files APIVideo

API-Modell-ID

minimax-h3

Eingaben

text, file

Files API

Für Referenzmodi erforderlich

Basis-Credits

Die Credits hängen von Eingaben und Einstellungen ab. Prüfe die Schätzung vor dem Generieren. Die endgültigen Auftragskosten werden auf ganze Credits aufgerundet.

Fähigkeit

Video

Abrechnung

METERED

Prompt-Limit

7000 Zeichen

Request-Kontrakt

Sende die Modell-ID auf Top-Level. Modellspezifische Controls gehören in params.

Key	Typ	Erforderlich	Standard	Beschreibung
model	string	Ja	minimax-h3	Verwende minimax-h3 als API-Modell-ID.
prompt	string	Ja	-	Maximal 7000 Zeichen für dieses Modell.
params	object	Nein	-	Modellspezifisches Parameterobjekt. Die erlaubten Keys stehen in den Zeilen darunter.
client_request_id	string	Nein	-	Optionale Client-ID, um Requests in deinem System nachzuverfolgen.

Modellparameter

Key	Typ	Erforderlich	Standard	Bereich	Optionen	Beschreibung
seedance_scene	select	Nein	text	-	text, frames, reference	Wähle vor dem Upload den MiniMax-Eingabeweg; für Text, Frames und Referenzen gelten eigene Anforderungen.
resolution	select	Nein	2K	-	768P, 2K	Die gewählte Stufe bestimmt den Sekundensatz für Ausgabe plus verifizierte Eingangsvideozeit.
aspect_ratio	select	Nein	16:9	-	adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Adaptiv ist im Referenzmodus verfügbar, nicht im Textmodus. Der Frame-Modus verwendet seine Bildgeometrie, statt diese Steuerung zu senden.
minimax_single_frame_role	select	Nein	first	-	first, last	Ja. Bei einem Bild wählst du, ob es der Start- oder Endframe ist. Bei zwei Bildern ordnest du sie als Start und danach Ende an.
duration	number	Nein	6	min 4 / max 15 / step 1	-	Wähle eine ganzzahlige Ausgabelänge von 4 bis einschließlich 15 Sekunden.

Upload-Richtlinie

Lade zuerst Referenzdateien hoch und setze dann die zurückgegebene URL und den durationToken in params.referenceMediaItems.

Referenzregel

Leitframes oder multimodale Referenzen: Frames akzeptiert 1 oder 2 JPEG-, PNG- oder WebP-Bilder mit jeweils bis zu 30 MB. Referenz akzeptiert bis zu 9 solcher Bilder, 3 MP4/MOV-Videos bis 50 MB und jeweils 2-15 Sekunden sowie 3 MP3/WAV-Audiodateien bis 15 MB und jeweils 2-15 Sekunden; Video und Audio sind insgesamt auf jeweils 15 Sekunden und alle Medien zusammen auf 15 Dateien begrenzt, außerdem kann Audio nicht allein verwendet werden.

Max. Dateien

Akzeptierte Dateitypen

image, video, audio

Duration Token

Video- und Audioreferenzen sollten durationToken aus /api/v1/files mitführen, wenn eine Dauerprüfung erforderlich ist.

kind	Max. Größe	MIME-Typen
image	30 MB	image/jpeg, image/png, image/webp
video	50 MB	video/mp4, video/quicktime
audio	15 MB	audio/mpeg, audio/wav, audio/x-wav

Minimalrequest

{
  "model": "minimax-h3",
  "prompt": "Eine Kamera umkreist langsam eine Produktflasche auf einem Studiotisch.",
  "params": {
    "seedance_scene": "text",
    "resolution": "2K",
    "aspect_ratio": "16:9",
    "minimax_single_frame_role": "first",
    "duration": 6
  }
}

Request mit Referenzdatei

{
  "model": "minimax-h3",
  "prompt": "Eine Kamera umkreist langsam eine Produktflasche auf einem Studiotisch.",
  "params": {
    "seedance_scene": "reference",
    "resolution": "2K",
    "aspect_ratio": "16:9",
    "minimax_single_frame_role": "first",
    "duration": 6,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-video.mp4",
        "kind": "video",
        "name": "reference-video.mp4",
        "mimeType": "video/mp4",
        "durationSeconds": 8,
        "durationToken": "video_duration_token_from_files_api",
        "width": 1280,
        "height": 720,
        "sizeBytes": 8388608,
        "framesPerSecond": 30,
        "videoBitrateMbps": 8,
        "videoMetadataToken": "video_metadata_token_from_original_files_api_upload_response"
      }
    ]
  }
}

Create-Response

Der Create-Endpunkt gibt eine öffentliche Task-ID zurück. Frage den Status-Endpunkt ab, bis der Task erfolgreich ist oder fehlschlägt.

{
  "id": "task_minimax_h3_example",
  "status": "queued",
  "model": "minimax-h3",
  "reserved_credits": 78,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Häufige Fehler

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Einige Modi benötigen Referenz-Uploads über Files API.

MiniMax H3 API-Integration