Gebruik Seedance 2.0 Mini via Rivya Public API v1 met model-id seedance-2-mini, ondersteunde inputs, parameters, Files API-regels, credits en responsevoorbeelden.

Beschikbaar via APITekst of URL gereed; referentiemodi gebruiken Files APIVideo

API-model-id

seedance-2-mini

Inputs

text, file

Files API

Vereist voor referentiemodi

Basiscredits

per_input_and_output_second · 480p_with_video=2.4 · 480p_without_video=3.8 · 720p_with_video=5 · 720p_without_video=8.2 · ⌈total⌉

Mogelijkheid

Video

Facturering

METERED

Promptlimiet

20000 tekens

Requestcontract

Stuur de model-id op topniveau. Modelspecifieke controles horen in params.

Key	Type	Vereist	Standaard	Beschrijving
model	string	Ja	seedance-2-mini	Gebruik de API-model-id seedance-2-mini.
prompt	string	Ja	-	Maximaal 20000 tekens voor dit model.
params	object	Nee	-	Modelspecifiek parameterobject. Gebruik de rijen hieronder voor toegestane keys.
client_request_id	string	Nee	-	Optionele client-side id voor requesttracing in je systeem.

Modelparameters

Key	Type	Vereist	Standaard	Bereik	Opties	Beschrijving
seedance_scene	select	Nee	text	-	text, frames, reference	De scène bepaalt welke uploads geldig zijn; tekst-, frame- en referentie-invoer kunnen niet worden gemengd.
resolution	select	Nee	720p	-	480p, 720p	Het tarief verandert per resolutie en op basis van de aanwezigheid van video in de referentiescène.
aspect_ratio	select	Nee	16:9	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive	Beeldverhouding
duration	number	Nee	5	min 4 / max 15 / step 1	-	Kies een gehele uitvoerduur van 4 tot en met 15 seconden.
generate_audio	select	Nee	true	-	true, false	Vraag gegenereerde audio aan bij de uitvoerclip.
web_search	select	Nee	false	-	false, true	Alleen beschikbaar voor tekst-naar-video; inschakelen met frames of referenties wordt geweigerd.
nsfw_checker	select	Nee	true	-	false, true	Schakel het optionele contentfilter van het model in. Geen enkel geautomatiseerd filter kan volledige dekking garanderen.

Uploadbeleid

Upload eerst referentiebestanden en plaats daarna de teruggegeven URL en duration token in params.referenceMediaItems.

Referentieregel

Richtingsframes of multimodale referenties: Frames accepteert één of twee JPEG/PNG/WebP/GIF-afbeeldingen van maximaal 30 MB per stuk. Referentie accepteert maximaal 9 zulke afbeeldingen, 3 MP4/MOV/MKV-video's van maximaal 50 MB en 2-15 seconden per stuk en 3 MP3/WAV-audiobestanden van maximaal 15 MB en 2-15 seconden per stuk; video en audio zijn elk begrensd op in totaal 15 seconden.

Max. bestanden

Geaccepteerde bestandstypen

image, video, audio

Duurtoken

Video- en audioreferenties moeten durationToken uit /api/v1/files bevatten wanneer duurverificatie vereist is.

kind	Max. grootte	MIME-types
image	30 MB	image/jpeg, image/png, image/webp, image/gif
video	50 MB	video/mp4, video/quicktime, video/x-matroska
audio	15 MB	audio/mpeg, audio/wav, audio/x-wav

Minimale request

{
  "model": "seedance-2-mini",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "web_search": "false",
    "nsfw_checker": "true"
  }
}

Request met referentiebestand

{
  "model": "seedance-2-mini",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "reference",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "web_search": "false",
    "nsfw_checker": "true",
    "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-response

Het create-endpoint geeft een publieke taak-id terug. Poll het statusendpoint totdat de taak slaagt of mislukt.

{
  "id": "task_seedance_2_mini_example",
  "status": "queued",
  "model": "seedance-2-mini",
  "reserved_credits": 41,
  "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
}

Veelvoorkomende fouten

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sommige modi vereisen referentie-uploads via Files API.

Seedance 2.0 Mini API-integratie