Seedance 2.5 API: aanroepen, parameters, limieten en creditkosten

Kort antwoord: je kunt Seedance 2.5 met één sleutel via de Yovid-API aanroepen. Stuur POST https://yovid.ai/v1/videos/generations met "model": "seedance-2.5" en een prompt, vraag daarna GET /v1/tasks/{task_id} op tot de status completed is en lees output.video_url uit. Clips duren 4 tot 30 seconden, en één request kan tot 30 afbeeldingen, 10 video's en 10 audiobestanden als referentie bevatten. De facturering gebruikt dezelfde Yovid-credits als de website, en credits worden pas afgeschreven als een taak slaagt.

Inhoud

1. Waar API-toegang tot Seedance 2.5 vandaan komt
2. Snel aan de slag in vier stappen
3. Requestparameters
4. Hoe de API de generatiemodus kiest
5. Limieten voor referenties en media
6. Wat een request kost
7. Fouten, retries en rate limits
8. Een volledig Python-voorbeeld
9. Veelgestelde vragen

Waar API-toegang tot Seedance 2.5 vandaan komt

Seedance 2.5 is een model van ByteDance Seed. ByteDance biedt ontwikkelaars toegang via zijn eigen cloudplatforms: volgens de lanceringspost van 31 juli 2026 zou API-toegang via BytePlus ModelArk komen, volgens persberichten opende Volcano Engine de API-toegang in China op 7 augustus, en de pagina van ByteDance over Seedance 2.5 linkt naar de BytePlus-playground.

Yovid is een onafhankelijk platform, niet verbonden aan ByteDance, en biedt Seedance 2.5 aan via een eigen API:

• Eén sleutel, één rekening. Dezelfde sleutel en dezelfde credits gelden voor Seedance 2.5, 2.0, 2.0 Fast, 2.0 Mini, 1.5 Pro en 1.0 Pro Fast.
• Stabiele publieke ID's. Je stuurt seedance-2.5; Yovid houdt de modelnamen van providers intern, zodat die kunnen veranderen zonder dat je code breekt.
• Hetzelfde account als op de website. Clips die je via de API genereert, gebruiken het abonnement en de credits die je al hebt.

De volledige referentie staat in de API-documentatie van Yovid (in het Engels); deze gids richt zich op wat specifiek is voor Seedance 2.5.

Snel aan de slag in vier stappen

1. Maak een API-sleutel aan

Open Instellingen → API-sleutels, geef de sleutel een naam en maak hem aan. Het volledige geheim wordt maar één keer getoond, dus bewaar het in een secret manager en laad het op je server als YOVID_API_KEY. Zet het nooit in browser- of mobiele code.

2. Maak een taak aan

curl https://yovid.ai/v1/videos/generations \
  -H "Authorization: Bearer $YOVID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "A lighthouse keeper climbs a spiral staircase with a lantern, reaches the lamp room as a storm rolls in, and lights the great lamp. Wind howling, boots on iron steps.",
    "duration": 10,
    "quality": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'

{
  "task_id": "vid_01JZK7R7KCYQ3T9F33A7K0J6XB",
  "status": "pending",
  "created_at": "2026-10-22T08:30:00.000Z"
}

3. Vraag de taak op

curl https://yovid.ai/v1/tasks/vid_01JZK7R7KCYQ3T9F33A7K0J6XB \
  -H "Authorization: Bearer $YOVID_API_KEY"

Vraag elke 5 tot 10 seconden op zolang de status pending of processing is, en bouw de wachttijd geleidelijk op. Wordt de status completed, dan staat de video-URL in output.video_url; wordt hij failed, stop dan met opvragen en lees error.

4. Controleer je credits

curl https://yovid.ai/v1/credits \
  -H "Authorization: Bearer $YOVID_API_KEY"

available is wat een nieuwe taak kan gebruiken; reserved is gereserveerd voor taken die nog lopen.

Requestparameters

De API controleert elke waarde tegen het model en je abonnement voordat er een taak wordt aangemaakt, en geeft een 403 of 422 terug met het foute veld in param als iets niet is toegestaan. Begin je met een frame, dan volgt de output de verhouding van die afbeelding.

Hoe de API de generatiemodus kiest

Je stuurt nooit een providermodus mee. Yovid kiest die op basis van de media die je meestuurt:

In referentiemodus verwijs je in de prompt naar bestanden op volgorde binnen elke array: @image1, @image2, @video1, @audio1. Een referentierequest ziet er zo uit:

{
  "model": "seedance-2.5",
  "prompt": "@image1 is the main character. @image2 is the ceramic mug she holds; keep its shape and logo. @image3 is the kitchen. She walks into the kitchen, pours coffee into the mug and turns to the window. Use @audio1 as her voice: she says, \"Finally, Saturday.\"",
  "image_urls": [
    "https://example.com/character.jpg",
    "https://example.com/mug.jpg",
    "https://example.com/kitchen.jpg"
  ],
  "audio_urls": ["https://example.com/voice-sample.mp3"],
  "duration": 12,
  "quality": "720p"
}

Audioreferenties zijn een API-functie: de composer op de website neemt afbeeldingen en video's, terwijl de API tot 10 audiobestanden toevoegt voor een stem, een track of een ritme.

Limieten voor referenties en media

Uit de pagina modellen en invoer (in het Engels) van de API-documentatie:

Alle media moeten publieke HTTPS-URL's zijn. Yovid weigert localhost, privé-netwerkadressen, URL's met ingesloten inloggegevens en hostnamen die niet te resolven zijn. Gebruik URL's in plaats van Base64; de provider beperkt de body van elk request tot 64 MB.

Wat een request kost

De API rekent af in dezelfde credits als de website, tegen dezelfde tarieven. Tegen de basistarieven van creditpakketten kost Seedance 2.5 ongeveer 3 credits per seconde in 480p en ongeveer 6,1 in 720p, dus een clip van 10 seconden in 720p kost ongeveer 61 credits en een van 30 seconden ongeveer 183. Met een abonnement betaal je minder per seconde.

• Referentievideo's worden berekend op de lengte van de referentieclip plus de lengte van de output, tegen een lager tarief: ongeveer 2,1 credits per seconde in 480p en 4,6 in 720p.
• content_filter uitzetten vermenigvuldigt de kosten met 1,1.
• Eerst reserveren, dan afschrijven. Credits worden gereserveerd als de taak wordt aangemaakt en pas afgeschreven als hij voltooid is; een mislukte taak geeft ze terug.
• Toegang per abonnement. Seedance 2.5 vraagt een betaald abonnement of een eenmalig creditpakket. Een gratis account krijgt 403 plan_upgrade_required.

De voltooide taak meldt het verbruik in credits_used. Bekijk de prijzenpagina voor abonnementen en pakketten, en Is Seedance 2.5 gratis? voor de goedkoopste manier om te beginnen.

Fouten, retries en rate limits

Elke sleutel staat tot 120 requests per minuut toe, en opvragen telt mee. Het endpoint voor aanmaken ondersteunt nog geen idempotency keys, dus herhaal een POST niet automatisch als je niet weet of de eerste is gelukt: dan kun je een tweede taak aanmaken en twee keer credits reserveren. Sla elke task_id op die je ontvangt.

Een volledig Python-voorbeeld

import os
import time

import requests

API = "https://yovid.ai"
HEADERS = {"Authorization": f"Bearer {os.environ['YOVID_API_KEY']}"}

create = requests.post(
    f"{API}/v1/videos/generations",
    headers=HEADERS,
    json={
        "model": "seedance-2.5",
        "prompt": (
            "0-10s: a courier in a yellow rain jacket runs out of a subway exit into a night street. "
            "10-20s: she weaves between umbrellas as a taxi brakes. "
            "20-30s: she stops at a door and knocks twice. Rain and traffic, no music."
        ),
        "duration": 30,
        "quality": "720p",
        "aspect_ratio": "16:9",
    },
    timeout=30,
)
create.raise_for_status()
task_id = create.json()["task_id"]

delay = 5
while True:
    task = requests.get(f"{API}/v1/tasks/{task_id}", headers=HEADERS, timeout=30)
    task.raise_for_status()
    data = task.json()
    if data["status"] == "completed":
        print(data["output"]["video_url"], data["credits_used"])
        break
    if data["status"] == "failed":
        raise RuntimeError(data["error"])
    time.sleep(delay)
    delay = min(delay * 1.5, 30)

De prompt gebruikt beats met tijdcodes, de betrouwbaarste manier om een clip van 30 seconden te vullen. De promptgids voor Seedance 2.5 bevat 13 prompts die je zo kunt versturen, en de vergelijkingen met Kling 3.0, Veo 3.1 en Seedance 2.0 helpen je kiezen welke model-ID je aanroept.

Veelgestelde vragen

Is er een officiële Seedance 2.5 API?

ByteDance biedt Seedance 2.5 aan ontwikkelaars aan via zijn cloudplatforms, Volcano Engine en BytePlus. De API van Yovid is een onafhankelijk alternatief: één sleutel en één creditsaldo voor Seedance 2.5 en de andere Seedance-modellen.

Wat is de model-ID van Seedance 2.5 op Yovid?

seedance-2.5. Andere publieke ID's zijn seedance-2.0, seedance-2.0-fast, seedance-2.0-mini, seedance-1.5-pro en seedance-1.0-pro-fast.

Hoe lang kan een video via de Seedance 2.5 API zijn?

4 tot 30 seconden per taak, in te stellen met duration.

Welke resoluties ondersteunt de Seedance 2.5 API?

De API-documentatie noemt 480p en 720p voor seedance-2.5. Ook je abonnement bepaalt een maximum, en de API geeft een 403 terug voordat er een taak wordt aangemaakt als de kwaliteit daarboven ligt.

Kan ik audio als referentie meesturen?

Ja, tot 10 MP3- of WAV-bestanden in audio_urls, in de prompt aangeduid als @audio1, @audio2 enzovoort. Audioreferenties zijn alleen via de API beschikbaar.

Kost een mislukte taak credits?

Nee. Credits worden gereserveerd als de taak wordt aangemaakt en pas afgeschreven als hij succesvol is voltooid.

Hoeveel requests mag ik doen?

Tot 120 requests per minuut per sleutel, opvragen inbegrepen, plus een limiet voor gelijktijdige taken die afhangt van je abonnement. Een 429 betekent: wacht en probeer opnieuw met backoff.

Klaar om te bouwen? Maak een sleutel aan in Instellingen → API-sleutels en volg de snelstart van de API (in het Engels).