MiniMax H3 modelini Rivya Public API v1 üzerinden model id minimax-h3, desteklenen girişler, parametreler, Files API kuralları, krediler ve yanıt örnekleriyle kullanın.

API üzerinden kullanılabilirMetin veya URL hazır; referans modları Files API kullanırVideo

API model kimliği

minimax-h3

Girişler

text, file

Files API

Referans modları için gerekli

Temel krediler

Kredi kullanımı girdilere ve ayarlara bağlıdır. Üretmeden önce tahmini kontrol edin. Görevin son maliyeti tam krediye yukarı yuvarlanır.

Yetenek

Video

Faturalandırma

METERED

Prompt limiti

7000 karakter

İstek sözleşmesi

Model id değerini en üst seviyede gönderin. Modele özel kontroller params içine aittir.

Anahtar	Tür	Gerekli	Varsayılan	Açıklama
model	string	Evet	minimax-h3	minimax-h3 API model kimliği değerini kullanın.
prompt	string	Evet	-	Bu model için en fazla 7000 karakter.
params	object	Hayır	-	Modele özel parametre nesnesi. İzin verilen anahtarlar için aşağıdaki satırları kullanın.
client_request_id	string	Hayır	-	Sisteminizde istekleri izlemek için isteğe bağlı istemci tarafı id.

Model parametreleri

Anahtar	Tür	Gerekli	Varsayılan	Aralık	Seçenekler	Açıklama
seedance_scene	select	Hayır	text	-	text, frames, reference	Yüklemeden önce MiniMax giriş yolunu seçin; metin, kareler ve referansların ayrı gereksinimleri vardır.
resolution	select	Hayır	2K	-	768P, 2K	Seçilen seçenek, çıktı ve doğrulanmış giriş videosu süresine uygulanacak saniye başına oranı belirler.
aspect_ratio	select	Hayır	16:9	-	adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Uyarlanabilir seçenek referans modunda kullanılabilir, metin modunda kullanılamaz. Kare modu bu kontrolü göndermek yerine görüntü geometrisini kullanır.
minimax_single_frame_role	select	Hayır	first	-	first, last	Evet. Tek görüntüde bunun başlangıç mı bitiş karesi mi olduğunu seçin. İki görüntüyü başlangıç ve ardından bitiş olarak sıralayın.
duration	number	Hayır	6	min 4 / max 15 / step 1	-	4 ile 15 saniye arasında tam sayı çıktı süresi seçin.

Yükleme politikası

Önce referans dosyalarını yükleyin, ardından dönen URLyi ve duration token değerini params.referenceMediaItems içine yerleştirin.

Referans kuralı

Kılavuz kareler veya çok modlu referanslar: Kareler sahnesi, her biri en fazla 30 MB olan 1 veya 2 JPEG, PNG ya da WebP görüntü kabul eder. Referans sahnesi en fazla bu tür 9 görüntü, her biri 50 MB ve 2–15 saniye olan 3 MP4/MOV video ve her biri 15 MB ve 2–15 saniye olan 3 MP3/WAV ses dosyası kabul eder; toplam video ve ses süreleri ayrı ayrı 15 saniye, tüm medya 15 dosyayla sınırlıdır ve ses tek başına kullanılamaz.

Maks. dosya

Kabul edilen dosya türleri

image, video, audio

Süre belirteci

Süre doğrulaması gerektiğinde video ve ses referansları /api/v1/files içinden durationToken taşımalıdır.

kind	Maks. boyut	MIME türleri
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

Minimal istek

{
  "model": "minimax-h3",
  "prompt": "Kamera, stüdyo masasındaki bir ürün şişesinin etrafında yavaşça döner.",
  "params": {
    "seedance_scene": "text",
    "resolution": "2K",
    "aspect_ratio": "16:9",
    "minimax_single_frame_role": "first",
    "duration": 6
  }
}

Referans dosyalı istek

{
  "model": "minimax-h3",
  "prompt": "Kamera, stüdyo masasındaki bir ürün şişesinin etrafında yavaşça döner.",
  "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 yanıtı

Create endpointi herkese açık task id döndürür. Görev başarılı veya başarısız olana kadar status endpointini sorgulayın.

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

Yaygın hatalar

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Bazı modlar Files API referans yüklemeleri gerektirir.

MiniMax H3 API Entegrasyonu