Använd MiniMax H3 via Rivyas publika API v1 med modell-ID minimax-h3, stödda inmatningar, parametrar, Files API-regler, krediter och svarsexempel.

Tillgänglig via APIText eller URL klar; referenslägen använder Files APIVideo

API-modell-ID

minimax-h3

Inmatningar

text, file

Files API

Krävs för referenslägen

Baskrediter

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

Förmåga

Video

Fakturering

METERED

Promptgräns

7000 tecken

Kontrakt för begäran

Skicka modell-ID:t på toppnivå. Modellspecifika kontroller hör hemma i params.

Nyckel	Typ	Obligatoriskt	Standard	Beskrivning
model	string	Ja	minimax-h3	Använd API-modell-ID:t minimax-h3.
prompt	string	Ja	-	Högst 7000 tecken för den här modellen.
params	object	Nej	-	Modellspecifikt parameterobjekt. Använd raderna nedan för tillåtna nycklar.
client_request_id	string	Nej	-	Valfritt klient-ID för att spåra begäranden i ditt system.

Modellparametrar

Nyckel	Typ	Obligatoriskt	Standard	Intervall	Alternativ	Beskrivning
seedance_scene	select	Nej	text	-	text, frames, reference	Välj MiniMax indataväg före uppladdning; text, bildrutor och referenser har separata krav.
resolution	select	Nej	2K	-	768P, 2K	Den valda nivån anger sekundpriset som tillämpas på output plus verifierad tid för indatavideo.
aspect_ratio	select	Nej	16:9	-	adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Adaptivt läge är tillgängligt i referensläget, inte textläget. Bildruteläget använder bildgeometrin i stället för att skicka den här kontrollen.
minimax_single_frame_role	select	Nej	first	-	first, last	Ja. Med en bild väljer du om den är start- eller slutbildrutan. Med två bilder ordnar du dem som start och sedan slut.
duration	number	Nej	6	min 4 / max 15 / step 1	-	Välj en heltalslängd för output från 4 till och med 15 sekunder.

Uppladdningspolicy

Ladda först upp referensfiler och placera sedan den returnerade URL:en och varaktighetstoken i params.referenceMediaItems.

Referensregel

Vägledande bildrutor eller multimodala referenser: Bildrutor accepterar 1 eller 2 JPEG-, PNG- eller WebP-bilder på högst 30 MB vardera. Referens accepterar upp till 9 sådana bilder, 3 MP4/MOV-videor på högst 50 MB och 2-15 sekunder vardera samt 3 MP3/WAV-ljudfiler på högst 15 MB och 2-15 sekunder vardera; video och ljud begränsas vart för sig till totalt 15 sekunder, samtliga medier begränsas till 15 filer och ljud kan inte användas ensamt.

Max filer

Godkända filtyper

image, video, audio

Varaktighetstoken

Video- och ljudreferenser bör innehålla durationToken från /api/v1/files när varaktighetsverifiering krävs.

kind	Max storlek	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 begäran

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

Begäran med referensfil

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

Skapa-svar

Create-endpointen returnerar ett publikt uppgifts-ID. Kontrollera status-endpointen tills uppgiften lyckas eller misslyckas.

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

Vanliga fel

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Vissa lägen kräver referensuppladdningar via Files API.

MiniMax H3 API-integration