Seedance 2.5.
In Ihrem Produkt.

Ihr erstes Video mit wenigen Anfragen.

Speichern Sie Ihren Schlüssel auf dem Server als SEADANCE_API_KEY. Setzen Sie SEADANCE_REQUEST_KEY auf einen eindeutigen Wert für dieses Video (zum Beispiel mit uuidgen) und behalten Sie diesen Wert bei Wiederholungen bei. Stellen Sie sicher, dass Ihr Konto genügend Credits enthält. Dieses Beispiel reserviert 350 Credits für ein 5-sekündiges 720p-Video. Kopieren Sie die zurückgegebene id, um den Status abzufragen.

export SEADANCE_API_KEY="sd_live_your_key"
# Keep this value for retries; choose a new value for a new video.
export SEADANCE_REQUEST_KEY="${SEADANCE_REQUEST_KEY:-$(uuidgen)}"

curl --fail-with-body "https://seedance3ai.dev/api/v1/videos" \
  -H "Authorization: Bearer $SEADANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SEADANCE_REQUEST_KEY" \
  --data '{
  "model": "seedance-2.5",
  "mode": "text-to-video",
  "prompt": "A paper boat floating through a sunlit stream, gentle camera movement",
  "aspectRatio": "16:9",
  "resolution": "720p",
  "duration": 5
}'

Diese Dokumentation startet niemals automatisch eine Generierung. Das Senden einer Erstellungsanfrage verbraucht Ihre Credits.

Authentifizieren Sie sich über Ihren Server.

Jeder API-Aufruf verwendet Authorization: Bearer sd_live_…. Speichern Sie Schlüssel nicht in Browsern, mobilen Apps, öffentlichen Repositories oder clientseitigen Bundles. Der vollständige Schlüssel wird nur einmal angezeigt; Sie können ihn im API-Dashboard widerrufen.

Standardberechtigungen der Schlüssel: videos:write für Uploads und Generierung; videos:read für Modelle und Aufgabenstatus; account:read für Credits. Kontozugriff und Limits gelten gemeinsam für alle Schlüssel.

Erstellen Sie eine Videoaufgabe.

Verwenden Sie Content-Type: application/json und für jede beabsichtigte Generierung einen eindeutigen Idempotency-Key. Die Annahme der Aufgabe beim Anbieter kann etwas dauern. Bei einem Verbindungs-Timeout senden Sie denselben Body mit demselben Schlüssel erneut. HTTP 202 bedeutet angenommen, nicht abgeschlossen. Idempotency-Key akzeptiert 1–128 druckbare ASCII-Zeichen ohne Leerzeichen.

Über diese Felder unterstützt Seedance 2.5 Text, erste und letzte Frames, multimodale Referenzen sowie die Bearbeitung und Verlängerung von Videos. Maßgeblich für aktuell verfügbare Funktionen und Preise ist GET /models.

{
  "model": "seedance-2.5",
  "mode": "image-to-video",
  "prompt": "A paper boat floating through a sunlit stream, gentle camera movement",
  "aspectRatio": "16:9",
  "resolution": "720p",
  "duration": 5,
  "firstFrameUrl": "YOUR_UPLOADED_PUBLIC_OBJECT_URL"
}

{
  "model": "seedance-2.5",
  "mode": "reference-to-video",
  "prompt": "A paper boat floating through a sunlit stream, gentle camera movement",
  "aspectRatio": "16:9",
  "resolution": "720p",
  "duration": 5,
  "referenceImageUrls": [
    "YOUR_UPLOADED_IMAGE_URL"
  ],
  "referenceVideoUrls": [
    "YOUR_UPLOADED_VIDEO_URL"
  ]
}

Einmal hochladen. Per URL referenzieren.

Senden Sie fileName, contentType, size (Bytes) und kind (image, video oder audio) an POST /uploads. Laden Sie die unveränderten Dateibytes vor expiresAt mit PUT an uploadUrl hoch und verwenden Sie dabei requiredHeaders. Nach erfolgreichem Upload nutzen Sie publicObjectUrl in der Generierungsanfrage. Referenzen müssen zum selben Konto gehören; beliebige externe URLs und base64-Eingaben werden nicht akzeptiert.

// Node.js 20+ · upload once, then use publicObjectUrl
import { readFile } from "node:fs/promises";

const bytes = await readFile("./first-frame.jpg");
const signed = await fetch("https://seedance3ai.dev/api/v1/uploads", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SEADANCE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    fileName: "first-frame.jpg", contentType: "image/jpeg",
    size: bytes.length, kind: "image",
  }),
});
const upload = await signed.json();
if (!signed.ok) throw new Error(JSON.stringify(upload));
const stored = await fetch(upload.uploadUrl, {
  method: "PUT", headers: upload.requiredHeaders, body: bytes,
});
if (!stored.ok) throw new Error("Upload failed");
console.log(upload.publicObjectUrl);
// Use this URL as firstFrameUrl in an image-to-video request.

Die angegebene Größe und der Inhaltstyp müssen mit der hochgeladenen Datei übereinstimmen. Upload-URLs laufen ab; fordern Sie bei Bedarf eine neue an. Dauer, Abmessungen und Format der Medien werden vor der Generierung geprüft.

Verfolgen Sie die Aufgabe bis zum Abschluss.

GET /videos/:id liefert den aktuellen Aufgabenstatus. Fragen Sie ihn alle 5–10 Sekunden ab, beenden Sie die Abfrage bei succeeded oder failed und verlängern Sie die Wartezeit, wenn Retry-After vorhanden ist. Abfragen sind auf API-Aufgaben Ihres Kontos beschränkt. Die aktuelle Integration verwendet Polling.

curl --fail-with-body "https://seedance3ai.dev/api/v1/videos/TASK_ID" \
  -H "Authorization: Bearer $SEADANCE_API_KEY"

{
  "id": "a1b2c3d4-1234-4567-8901-abcdef123456",
  "status": "succeeded",
  "credits_reserved": 350,
  "created_at": "2026-10-27T00:00:00.000Z",
  "output": {
    "url": "https://your-result-host.example/video.mp4"
  },
  "error": null,
  "refund_status": "not_applicable"
}

output ist null, bis ein Video verfügbar ist. Eine fehlgeschlagene Aufgabe enthält einen Fehler; prüfen Sie refund_status für den Status der Credit-Erstattung. Laden Sie erfolgreiche Ergebnisse zeitnah herunter. Das Löschen eines Videos setzt die Anfrage nicht zurück: Eine Wiederholung mit demselben Idempotency-Key gibt 410 video_deleted zurück und kann das Video nicht erneut erstellen.

Kennen Sie die Credit-Kosten vor der Integration.

API-Generierungen nutzen dieselben Konto-Credits und Tarife für Seedance 2.5 wie die Website. Bei Annahme einer Anfrage werden Credits reserviert. Fehlgeschlagene Generierungen erstatten diese Credits auf Ihr Einmalguthaben. Eine fehlgeschlagene Validierung vor der Aufgabenerstellung erzeugt kein kostenpflichtiges Video.

Kosten = Ausgabedauer × Ausgabetarif plus gegebenenfalls Referenzvideodauer × Referenztarif. Die Referenzvideodauer wird auf dem Server gemessen; die Gesamtdauer wird für die Abrechnung auf volle Sekunden abgerundet. Native Audioausgabe ist enthalten. Beispielsweise kosten 5 Sekunden in 720p 350 Credits oder 600 Credits mit einem 5-sekündigen Referenzvideo.

curl --fail-with-body "https://seedance3ai.dev/api/v1/models" \
  -H "Authorization: Bearer $SEADANCE_API_KEY"

curl --fail-with-body "https://seedance3ai.dev/api/v1/credits" \
  -H "Authorization: Bearer $SEADANCE_API_KEY"

Im API-Dashboard sehen Sie verfügbare Credits, den Anfrageverlauf und Kontolimits. Laden Sie Credits über die Preisseite der Website mit demselben Konto auf; es gibt weder ein separates API-Guthaben noch einen API-Endpunkt zum Aufladen. Bei ausreichendem Credit-Guthaben ist kein aktives Abonnement erforderlich. Für den Ablauf von Abonnements und Einmal-Credits gelten dieselben Regeln wie auf der Website.

Das Aufladen von Credits erhöht weder Anfragerate, Parallelität noch Tageslimits und aktiviert kein deaktiviertes Konto erneut. Das Tageslimit zählt alle reservierten Credits einschließlich erstatteter Fehlversuche und wird um 00:00 UTC zurückgesetzt. Kontaktieren Sie den Support, wenn Ihre Anwendung höhere Limits benötigt.

Sicher wiederholen. Doppelte Kosten vermeiden.

Verwenden Sie pro beabsichtigtem Video einen Idempotency-Key und bewahren Sie ihn zusammen mit dem exakten Anfrage-Body auf, bis das Ergebnis bekannt ist. Neue Schlüssel stehen für neue Generierungen. Eine Fehlerantwort enthält error.code, error.message und request_id; geben Sie die Anfrage-ID an, wenn Sie den Support kontaktieren.