Χρησιμοποιήστε το MiniMax H3 μέσω του Rivya Public API v1 με αναγνωριστικό μοντέλου minimax-h3, υποστηριζόμενες εισόδους, παραμέτρους, κανόνες Files API, credits και παραδείγματα απόκρισης.

Διαθέσιμο μέσω APIΚείμενο ή URL έτοιμο. Οι λειτουργίες αναφοράς χρησιμοποιούν το Files APIΒίντεο

ID μοντέλου API

minimax-h3

Είσοδοι

text, file

Files API

Απαιτείται για λειτουργίες αναφοράς

Βασικές πιστώσεις

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

Δυνατότητα

Βίντεο

Χρέωση

METERED

Όριο prompt

7000 χαρακτήρες

Σύμβαση αιτήματος

Στείλτε το αναγνωριστικό μοντέλου στο ανώτερο επίπεδο. Οι έλεγχοι που είναι ειδικοί για το μοντέλο ανήκουν στο params.

Κλειδί	Τύπος	Υποχρεωτικό	Προεπιλογή	Περιγραφή
model	string	Ναι	minimax-h3	Χρησιμοποιήστε το minimax-h3 ως αναγνωριστικό μοντέλου API.
prompt	string	Ναι	-	Μέγιστο 7000 χαρακτήρες για αυτό το μοντέλο.
params	object	Όχι	-	Αντικείμενο παραμέτρων ειδικό για το μοντέλο. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα κλειδιά.
client_request_id	string	Όχι	-	Προαιρετικό client-side id για ιχνηλάτηση αιτημάτων στο δικό σας σύστημα.

Παράμετροι μοντέλου

Κλειδί	Τύπος	Υποχρεωτικό	Προεπιλογή	Εύρος	Επιλογές	Περιγραφή
seedance_scene	select	Όχι	text	-	text, frames, reference	Επιλέξτε τη ροή εισόδου MiniMax πριν από τη μεταφόρτωση· το κείμενο, τα καρέ και οι αναφορές έχουν ξεχωριστές απαιτήσεις.
resolution	select	Όχι	2K	-	768P, 2K	Η επιλεγμένη βαθμίδα ορίζει τον ανά δευτερόλεπτο συντελεστή που εφαρμόζεται στην έξοδο συν τον επαληθευμένο χρόνο εισόδου βίντεο.
aspect_ratio	select	Όχι	16:9	-	adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Η προσαρμοστική επιλογή διατίθεται στη λειτουργία αναφοράς, όχι στη λειτουργία κειμένου. Η λειτουργία καρέ χρησιμοποιεί τη γεωμετρία της εικόνας αντί να στέλνει αυτόν τον έλεγχο.
minimax_single_frame_role	select	Όχι	first	-	first, last	Ναι. Με μία εικόνα, επιλέξτε αν είναι το αρχικό ή το τελικό καρέ. Με δύο εικόνες, ταξινομήστε τες ως αρχή και έπειτα τέλος.
duration	number	Όχι	6	min 4 / max 15 / step 1	-	Επιλέξτε ακέραια διάρκεια εξόδου από 4 έως και 15 δευτερόλεπτα.

Πολιτική μεταφόρτωσης

Ανεβάστε πρώτα αρχεία αναφοράς και μετά τοποθετήστε το URL που επιστράφηκε και το duration token μέσα στο params.referenceMediaItems.

Κανόνας αναφοράς

Καρέ καθοδήγησης ή πολυτροπικές αναφορές: Η σκηνή καρέ δέχεται 1 ή 2 εικόνες JPEG, PNG ή WebP έως 30 MB η καθεμία. Η σκηνή αναφοράς δέχεται έως 9 τέτοιες εικόνες, 3 βίντεο MP4/MOV έως 50 MB και 2-15 δευτερόλεπτα το καθένα και 3 αρχεία ήχου MP3/WAV έως 15 MB και 2-15 δευτερόλεπτα το καθένα· το συνολικό βίντεο και ο συνολικός ήχος περιορίζονται χωριστά σε 15 δευτερόλεπτα, όλα τα πολυμέσα σε 15 αρχεία και ο ήχος δεν μπορεί να χρησιμοποιηθεί μόνος του.

Μέγιστος αριθμός αρχείων

Αποδεκτοί τύποι αρχείων

image, video, audio

Token διάρκειας

Οι αναφορές βίντεο και ήχου πρέπει να μεταφέρουν `durationToken` από το /api/v1/files όταν απαιτείται επαλήθευση διάρκειας.

kind	Μέγιστο μέγεθος	MIME types
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

Ελάχιστο αίτημα

{
  "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
  }
}

Αίτημα με αρχείο αναφοράς

{
  "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"
      }
    ]
  }
}

Απόκριση δημιουργίας

Το τελικό σημείο δημιουργίας επιστρέφει δημόσιο αναγνωριστικό εργασίας. Ελέγχετε περιοδικά το τελικό σημείο κατάστασης μέχρι η εργασία να ολοκληρωθεί με επιτυχία ή να αποτύχει.

{
  "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
}

Συνηθισμένα σφάλματα

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Ορισμένες λειτουργίες απαιτούν μεταφορτώσεις αναφοράς μέσω Files API.

Ενσωμάτωση API για MiniMax H3