Utilisez MiniMax H3 via Rivya Public API v1 avec le model id minimax-h3, les entrées prises en charge, les paramètres, les règles Files API, les crédits et des exemples de réponse.

Disponible via APITexte ou URL prêt ; les modes de référence utilisent Files APIVidéo

ID de modèle API

minimax-h3

Entrées

text, file

Files API

Requis pour les modes avec référence

Crédits de base

per_input_and_output_second · 768P=16 · 2K=26 · additional_image_after_five=8 · ⌈total⌉

Capacité

Vidéo

Facturation

METERED

Limite de prompt

7000 caractères

Contrat de requête

Envoyez l'ID du modèle au niveau supérieur. Les contrôles propres au modèle vont dans params.

Clé	Type	Obligatoire	Par défaut	Description
model	string	Oui	minimax-h3	Utilisez minimax-h3 comme ID de modèle API.
prompt	string	Oui	-	Maximum 7000 caractères pour ce modèle.
params	object	Non	-	Objet de paramètres propre au modèle. Consultez les lignes ci-dessous pour les clés autorisées.
client_request_id	string	Non	-	ID côté client facultatif pour tracer les requêtes dans votre système.

Paramètres du modèle

Clé	Type	Obligatoire	Par défaut	Plage	Options	Description
seedance_scene	select	Non	text	-	text, frames, reference	Choisissez le parcours d’entrée MiniMax avant l’importation ; le texte, les images et les références répondent à des exigences distinctes.
resolution	select	Non	2K	-	768P, 2K	Le palier choisi fixe le tarif par seconde appliqué à la sortie et au temps vérifié des vidéos d’entrée.
aspect_ratio	select	Non	16:9	-	adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Le choix adaptatif est disponible en mode référence, pas en mode texte. Le mode images utilise les dimensions de ses images au lieu d’envoyer ce réglage.
minimax_single_frame_role	select	Non	first	-	first, last	Oui. Avec une image, choisissez si elle sert d’image de départ ou de fin. Avec deux images, placez-les dans l’ordre début puis fin.
duration	number	Non	6	min 4 / max 15 / step 1	-	Choisissez une durée de sortie en secondes entières, de 4 à 15.

Règle d'importation

Importez d'abord les fichiers de référence, puis placez l'URL renvoyée et le durationToken dans params.referenceMediaItems.

Règle de référence

Images guides ou références multimodales: Le scénario images accepte 1 ou 2 images JPEG, PNG ou WebP de 30 MB maximum chacune. Le scénario référence accepte jusqu’à 9 images de ces formats, 3 vidéos MP4/MOV de 50 MB maximum et de 2 à 15 secondes chacune, ainsi que 3 fichiers audio MP3/WAV de 15 MB maximum et de 2 à 15 secondes chacun ; les durées cumulées de la vidéo et de l’audio sont chacune plafonnées à 15 secondes, l’ensemble des médias à 15 fichiers, et l’audio ne peut pas être utilisé seul.

Nombre max. de fichiers

Types de fichier acceptés

image, video, audio

Duration token

Les références vidéo et audio doivent inclure durationToken depuis /api/v1/files lorsqu'une vérification de durée est requise.

kind	Taille max.	Types MIME
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

Requête minimale

{
  "model": "minimax-h3",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "text",
    "resolution": "2K",
    "aspect_ratio": "16:9",
    "minimax_single_frame_role": "first",
    "duration": 6
  }
}

Requête avec fichier de référence

{
  "model": "minimax-h3",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "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"
      }
    ]
  }
}

Réponse de création

L'endpoint de création renvoie un ID de tâche public. Interrogez l'endpoint de statut jusqu'à ce que la tâche réussisse ou échoue.

{
  "id": "task_minimax_h3_example",
  "status": "queued",
  "model": "minimax-h3",
  "reserved_credits": 156,
  "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
}

Erreurs courantes

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Certains modes exigent des importations de référence via Files API.

Intégration API MiniMax H3