Bruk MiniMax H3 via Rivya Public API v1 med modell-ID minimax-h3, støttede inndata, parametere, Files API-regler, kreditter og svareksempler.

Tilgjengelig via APITekst- eller URL-inndata er klare; referansemoduser bruker Files APIVideo

API-modell-ID

minimax-h3

Inndata

text, file

Files API

Kreves for referansemoduser

Basiskreditter

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

Egenskap

Video

Fakturering

METERED

Promptgrense

7000 tegn

Forespørselskontrakt

Send modell-ID-en på toppnivå. Modellspesifikke kontroller hører hjemme i params.

Nøkkel	Type	Påkrevd	Standard	Beskrivelse
model	string	Ja	minimax-h3	Bruk API-modell-ID-en minimax-h3.
prompt	string	Ja	-	Maksimalt 7000 tegn for denne modellen.
params	object	Nei	-	Modellspesifikt parameterobjekt. Bruk radene nedenfor for tillatte nøkler.
client_request_id	string	Nei	-	Valgfri klient-ID for sporing av forespørsler i systemet ditt.

Modellparametere

Nøkkel	Type	Påkrevd	Standard	Område	Alternativer	Beskrivelse
seedance_scene	select	Nei	text	-	text, frames, reference	Velg MiniMax-flyten før opplasting; tekst, rammer og referanser har egne krav.
resolution	select	Nei	2K	-	768P, 2K	Valgt nivå bestemmer satsen per sekund for utdata pluss verifisert videoinndata.
aspect_ratio	select	Nei	16:9	-	adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Tilpasset er tilgjengelig i referansemodus, ikke tekstmodus. Rammemodus bruker bildegeometrien i stedet for å sende denne kontrollen.
minimax_single_frame_role	select	Nei	first	-	first, last	Ja. Med ett bilde velger du om det er start- eller sluttrammen. Med to bilder ordner du dem som start og deretter slutt.
duration	number	Nei	6	min 4 / max 15 / step 1	-	Velg en heltallslengde fra 4 til og med 15 sekunder.

Opplastingspolicy

Last opp referansefiler først, og plasser deretter returnert URL og varighetstoken i params.referenceMediaItems.

Referanseregel

Styringsrammer eller multimodale referanser: Rammer godtar 1 eller 2 JPEG-, PNG- eller WebP-bilder på opptil 30 MB hver. Referanse godtar opptil 9 slike bilder, 3 MP4/MOV-videoer på opptil 50 MB og 2-15 sekunder hver og 3 MP3/WAV-lydfiler på opptil 15 MB og 2-15 sekunder hver; samlet video- og lydlengde er begrenset til 15 sekunder for hver medietype, alle medier er begrenset til 15 filer, og lyd kan ikke brukes alene.

Maks antall filer

Godtatte filtyper

image, video, audio

Varighetstoken

Video- og lydreferanser bør ha durationToken fra /api/v1/files når varighetsverifisering kreves.

kind	Maks størrelse	MIME-typer
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 forespørsel

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

Referansefilforespørsel

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

Opprettelsessvar

Opprettingsendepunktet returnerer en offentlig oppgave-ID. Hent status fra statusendepunktet til oppgaven lykkes eller mislykkes.

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

Vanlige feil

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Noen moduser krever referanseopplastinger via Files API.

MiniMax H3 API-integrasjon