Gunakan MiniMax H3 melalui Rivya Public API v1 dengan ID model minimax-h3, input disokong, parameter, peraturan Files API, kredit dan contoh respons.

Tersedia melalui APITeks atau URL sedia; mod rujukan menggunakan Files APIVideo

ID model API

minimax-h3

Input

text, file

Files API

Diperlukan untuk mod rujukan

Kredit asas

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

Keupayaan

Video

Bil

METERED

Had prompt

7000 aksara

Kontrak permintaan

Hantar ID model pada peringkat atas. Kawalan khusus model berada dalam params.

Kunci	Jenis	Wajib	Lalai	Penerangan
model	string	Ya	minimax-h3	Gunakan ID model API minimax-h3.
prompt	string	Ya	-	Maksimum 7000 aksara untuk model ini.
params	object	Tidak	-	Objek parameter khusus model. Gunakan baris di bawah untuk kunci yang dibenarkan.
client_request_id	string	Tidak	-	ID sisi klien pilihan untuk menjejak permintaan dalam sistem anda.

Parameter model

Kunci	Jenis	Wajib	Lalai	Julat	Pilihan	Penerangan
seedance_scene	select	Tidak	text	-	text, frames, reference	Pilih laluan input MiniMax sebelum memuat naik; teks, bingkai dan rujukan mempunyai keperluan berasingan.
resolution	select	Tidak	2K	-	768P, 2K	Peringkat yang dipilih menetapkan kadar sesaat yang dikenakan pada output serta masa video input yang disahkan.
aspect_ratio	select	Tidak	16:9	-	adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Adaptif tersedia dalam mod rujukan, bukan mod teks. Mod bingkai menggunakan geometri imejnya dan bukannya menghantar kawalan ini.
minimax_single_frame_role	select	Tidak	first	-	first, last	Ya. Dengan satu imej, pilih sama ada ia bingkai mula atau akhir. Dengan dua imej, susunkannya sebagai mula kemudian akhir.
duration	number	Tidak	6	min 4 / max 15 / step 1	-	Pilih tempoh output nombor bulat dari 4 hingga 15 saat.

Polisi muat naik

Muat naik fail rujukan dahulu, kemudian letakkan URL dan token durasi yang dikembalikan dalam params.referenceMediaItems.

Peraturan rujukan

Bingkai panduan atau rujukan multimodal: Bingkai menerima 1 atau 2 imej JPEG, PNG atau WebP sehingga 30 MB setiap satu. Rujukan menerima sehingga 9 imej sedemikian, 3 video MP4/MOV sehingga 50 MB dan 2-15 saat setiap satu, serta 3 fail audio MP3/WAV sehingga 15 MB dan 2-15 saat setiap satu; jumlah video dan audio masing-masing dihadkan kepada 15 saat, semua media dihadkan kepada 15 fail dan audio tidak boleh digunakan sendirian.

Fail maksimum

Jenis fail diterima

image, video, audio

Token durasi

Rujukan video dan audio patut membawa durationToken daripada /api/v1/files apabila pengesahan durasi diperlukan.

kind	Saiz maksimum	Jenis 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

Permintaan minimum

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

Permintaan fail rujukan

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

Respons cipta

Endpoint cipta mengembalikan ID tugasan awam. Semak endpoint status sehingga tugasan berjaya atau gagal.

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

Ralat biasa

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sesetengah mod memerlukan muat naik rujukan Files API.

Integrasi API MiniMax H3