Seedance 2.5 API: Aufruf, Parameter, Limits und Credit-Kosten

Kurz gesagt: Du kannst Seedance 2.5 mit einem einzigen Schlüssel über die Yovid-API aufrufen. Sende POST https://yovid.ai/v1/videos/generations mit "model": "seedance-2.5" und einem Prompt, frag dann GET /v1/tasks/{task_id} ab, bis der Status completed lautet, und lies output.video_url aus. Clips dauern 4 bis 30 Sekunden, und eine Anfrage kann bis zu 30 Bilder, 10 Videos und 10 Audiodateien als Referenzen enthalten. Abgerechnet wird in denselben Yovid-Credits wie auf der Website, und Credits werden nur abgezogen, wenn ein Task erfolgreich ist.

Inhalt

1. Woher der API-Zugang zu Seedance 2.5 kommt
2. Schnellstart in vier Schritten
3. Request-Parameter
4. Wie die API den Generierungsmodus wählt
5. Referenz- und Medienlimits
6. Was eine Anfrage kostet
7. Fehler, Wiederholungen und Rate-Limits
8. Ein vollständiges Python-Beispiel
9. Häufige Fragen

Woher der API-Zugang zu Seedance 2.5 kommt

Seedance 2.5 ist das Modell von ByteDance Seed. Der eigene Entwicklerweg von ByteDance führt über seine Cloud-Plattformen: Laut dem Launch-Beitrag vom 31. Juli 2026 sollte der API-Zugang über BytePlus ModelArk folgen, laut Presseberichten hat Volcano Engine den API-Zugang in China am 7. August geöffnet, und die Seedance-2.5-Seite von ByteDance verlinkt auf den Playground von BytePlus.

Yovid ist eine unabhängige Plattform, nicht mit ByteDance verbunden, und bietet Seedance 2.5 über eine eigene API an:

• Ein Schlüssel, eine Rechnung. Derselbe Schlüssel und dieselben Credits gelten für Seedance 2.5, 2.0, 2.0 Fast, 2.0 Mini, 1.5 Pro und 1.0 Pro Fast.
• Stabile öffentliche IDs. Du sendest seedance-2.5; Yovid hält die Modellnamen der Anbieter intern, damit sie sich ändern können, ohne deinen Code zu brechen.
• Dasselbe Konto wie auf der Website. Clips, die du über die API erzeugst, nutzen den Plan und die Credits, die du schon hast.

Die vollständige Referenz steht in der Yovid-API-Dokumentation (auf Englisch); dieser Guide konzentriert sich auf das, was speziell für Seedance 2.5 gilt.

Schnellstart in vier Schritten

1. API-Schlüssel erstellen

Öffne Einstellungen → API-Schlüssel, gib dem Schlüssel einen Namen und erstelle ihn. Der vollständige geheime Schlüssel wird nur einmal angezeigt. Speichere ihn also in einem Secret Manager und lade ihn auf deinem Server als YOVID_API_KEY. Pack ihn niemals in Browser- oder Mobile-Code.

2. Task anlegen

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. Task abfragen

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

Frag alle 5 bis 10 Sekunden ab, solange der Status pending oder processing ist, und vergrößere die Abstände nach und nach. Wechselt er auf completed, steht die Video-URL in output.video_url; wechselt er auf failed, hör mit dem Abfragen auf und lies error.

4. Credits prüfen

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

available ist das, was ein neuer Task nutzen kann; reserved ist für noch laufende Tasks zurückgehalten.

Request-Parameter

Die API prüft jeden Wert gegen das Modell und deinen Plan, bevor sie einen Task anlegt, und gibt 403 oder 422 mit dem beanstandeten Feld in param zurück, wenn etwas nicht erlaubt ist. Startest du mit einem Startbild, richtet sich die Ausgabe nach dessen Format.

Wie die API den Generierungsmodus wählt

Einen Anbietermodus sendest du nie. Yovid wählt ihn anhand der Medien, die du anhängst:

Im Referenzmodus sprichst du Dateien im Prompt in der Reihenfolge an, in der sie im jeweiligen Array stehen: @image1, @image2, @video1, @audio1. Eine Referenzanfrage sieht so aus:

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

Audio-Referenzen sind eine API-Funktion: Das Eingabefeld auf der Website nimmt Bilder und Videos an, die API ergänzt bis zu 10 Audiodateien für eine Stimme, einen Track oder einen Rhythmus.

Referenz- und Medienlimits

Laut der Seite Modelle und Eingaben in der API-Dokumentation:

Alle Medien müssen öffentliche HTTPS-URLs sein. Yovid lehnt localhost, private Netzwerkadressen, URLs mit eingebetteten Zugangsdaten und Hostnamen ab, die sich nicht auflösen lassen. Nutze URLs statt Base64; der Anbieter begrenzt jeden Request-Body auf 64 MB.

Was eine Anfrage kostet

Die API rechnet in denselben Credits ab wie die Website, zu denselben Preisen. Zu den Standardpreisen der Credit-Pakete kostet Seedance 2.5 etwa 3 Credits pro Sekunde in 480p und etwa 6,1 in 720p; ein 10-Sekunden-Clip in 720p kostet also etwa 61 Credits und einer mit 30 Sekunden etwa 183. Mit Abo zahlst du weniger pro Sekunde.

• Referenzvideos werden nach der Länge des Referenzclips plus der Ausgabelänge abgerechnet, zu einem niedrigeren Preis: etwa 2,1 Credits pro Sekunde in 480p und 4,6 in 720p.
• Wenn du content_filter abschaltest, steigen die Kosten um den Faktor 1,1.
• Erst reservieren, dann abziehen. Credits werden beim Anlegen des Tasks reserviert und nur abgezogen, wenn er abgeschlossen wird; ein fehlgeschlagener Task gibt sie zurück.
• Planzugang. Seedance 2.5 braucht einen bezahlten Plan oder ein einmaliges Credit-Paket. Ein kostenloses Konto bekommt 403 plan_upgrade_required.

Der abgeschlossene Task meldet in credits_used, was er verbraucht hat. Pläne und Pakete findest du auf der Preisseite, den günstigsten Einstieg im Artikel Ist Seedance 2.5 kostenlos?.

Fehler, Wiederholungen und Rate-Limits

Jeder Schlüssel erlaubt bis zu 120 Anfragen pro Minute, und das Abfragen zählt mit. Der Create-Endpunkt unterstützt noch keine Idempotenzschlüssel. Wiederhole einen POST deshalb nicht automatisch, wenn du nicht weißt, ob der erste erfolgreich war: Das kann einen zweiten Task anlegen und Credits doppelt reservieren. Notiere jede task_id, die du bekommst.

Ein vollständiges Python-Beispiel

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)

Der Prompt nutzt Beats mit Zeitangaben, die zuverlässigste Methode, einen 30-Sekunden-Clip zu füllen. Der Prompt-Guide für Seedance 2.5 enthält 13 Prompts, die du unverändert senden kannst, und die Vergleiche mit Kling 3.0, Veo 3.1 und Seedance 2.0 helfen dir bei der Wahl der Modell-ID.

Häufige Fragen

Gibt es eine offizielle Seedance-2.5-API?

ByteDance bietet Seedance 2.5 Entwicklern über seine Cloud-Plattformen Volcano Engine und BytePlus an. Die API von Yovid ist eine unabhängige Alternative: ein Schlüssel und ein Credit-Guthaben für Seedance 2.5 und die anderen Seedance-Modelle.

Wie lautet die Modell-ID für Seedance 2.5 auf Yovid?

seedance-2.5. Weitere öffentliche IDs sind seedance-2.0, seedance-2.0-fast, seedance-2.0-mini, seedance-1.5-pro und seedance-1.0-pro-fast.

Wie lang kann ein Video über die Seedance-2.5-API sein?

4 bis 30 Sekunden pro Task, festgelegt mit duration.

Welche Auflösungen unterstützt die Seedance-2.5-API?

Die API-Dokumentation nennt 480p und 720p für seedance-2.5. Dein Plan setzt zusätzlich eine Obergrenze, und die API gibt vor dem Anlegen eines Tasks 403 zurück, wenn die Qualität darüber liegt.

Kann ich Audio als Referenz senden?

Ja, bis zu 10 MP3- oder WAV-Dateien in audio_urls, im Prompt angesprochen als @audio1, @audio2 und so weiter. Audio-Referenzen gibt es nur über die API.

Kostet ein fehlgeschlagener Task Credits?

Nein. Credits werden beim Anlegen des Tasks reserviert und nur abgezogen, wenn er erfolgreich abgeschlossen wird.

Wie viele Anfragen kann ich stellen?

Bis zu 120 Anfragen pro Minute und Schlüssel, Abfragen eingeschlossen, plus ein Limit für gleichzeitige Tasks, das von deinem Plan abhängt. Eine 429-Antwort heißt: warten und mit Backoff erneut versuchen.

Bereit zum Loslegen? Erstelle einen Schlüssel unter Einstellungen → API-Schlüssel und folge dem API-Schnellstart.