ENTWICKLERDOKUMENTATION

Direkt von der Beschreibung zum Video.

Diese Beispiele rufen SeedanceLink auf. Verwenden Sie Ihren eigenen API-Schlüssel; die Google-Anmeldung ist für die Webkonsole bestimmt.

Bevor Sie beginnen

Melden Sie sich an, laden Sie genügend Guthaben für das Preisangebot auf und erstellen Sie einen Schlüssel in einer Gruppe mit aktiviertem Seedance. Das kleinste Beispiel unten fordert 4 Sekunden in 480p an.

Eigenen API-Schlüssel erstellen Modelle und Preise

Authentifizierung

Senden Sie Authorization: Bearer YOUR_API_KEY bei Anfragen zur Erstellung, zum Status und zum Inhalt. Verwenden Sie denselben Schlüssel, mit dem die Aufgabe erstellt wurde. Schreiben Sie Ihren Schlüssel niemals in eine URL.

Authorization: Bearer YOUR_API_KEY

API-Ursprunghttps://seedancelink.io

Beispielmodell

Ohne Angaben beträgt die Dauer 5 Sekunden und die Auflösung 720p. Diese Beispiele wählen ausdrücklich 4 Sekunden und 480p. Senden Sie application/json und verwenden Sie eine der beiden Modell-IDs auf der Modellseite.

Führe diese curl-Beispiele im selben macOS/Linux-Terminal oder in Windows WSL aus. Das erste setzt deinen Schlüssel und die API-Adresse dieser Website. Halte den Schlüssel geheim.

Aufgabe erstellen

Dieses Beispiel fordert 4 Sekunden Video an. Speichere die zurückgegebene id. Seedance 2.0 unterstützt 4–15 Sekunden, Seedance 2.5 4–30. Beide unterstützen 480p, 720p und 1080p.

POST /api/v3/contents/generations/tasks

API_KEY='YOUR_API_KEY'
API_BASE='https://seedancelink.io'

curl --fail-with-body --request POST "$API_BASE/api/v3/contents/generations/tasks" \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "seedance-2.0-933",
  "content": [
    {
      "type": "text",
      "text": "Ein kleines Boot fährt bei Sonnenaufgang über einen ruhigen See, filmische Beleuchtung."
    }
  ],
  "duration": 4,
  "resolution": "480p",
  "ratio": "16:9"
}'

Beispielantwort

{
  "id": "YOUR_TASK_ID",
  "status": "queued"
}

Speichern Sie die Aufgaben-ID aus der Antwort und verwenden Sie sie in den nächsten beiden Schritten.

Status abfragen

Ersetze REPLACE_WITH_RESPONSE_ID durch diese id. Prüfe bei queued oder running alle 15 Sekunden. Lade bei succeeded herunter. Stoppe bei failed oder needs_reconcile; kontaktiere bei needs_reconcile den Support. Nicht automatisch erneut einreichen.

GET /api/v3/contents/generations/tasks/<task_id>

TASK_ID='REPLACE_WITH_RESPONSE_ID'

curl --fail-with-body "$API_BASE/api/v3/contents/generations/tasks/$TASK_ID" \
  --header "Authorization: Bearer $API_KEY"

Beispielantwort

{
  "id": "YOUR_TASK_ID",
  "status": "succeeded"
}

Fragen Sie etwa alle 15 Sekunden ab. Laden Sie erst beim Status succeeded herunter.

Video herunterladen

Nutze denselben Schlüssel wie beim Erstellen. Dieser geschützte Endpunkt benötigt deinen Bearer-Schlüssel; die URL allein im Browser reicht nicht. curl folgt HTTPS-Weiterleitungen ohne den Schlüssel an andere Hosts weiterzugeben.

GET /api/v3/contents/generations/tasks/<task_id>/content

curl --fail --location --proto-redir '=https' --max-redirs 3 \
  "$API_BASE/api/v3/contents/generations/tasks/$TASK_ID/content" \
  --header "Authorization: Bearer $API_KEY" \
  --output video.mp4

Aufgabenstatus und Abrechnung

queued: Angenommen und wartend.
running: Die Generierung läuft.
succeeded: Abgeschlossen; der authentifizierte Inhaltsendpunkt ist bereit.
failed: Die Generierung ist fehlgeschlagen; der reservierte Betrag wurde zurückgegeben.
needs_reconcile: Das Ergebnis der Übermittlung ist unklar; der Betrag bleibt zur Prüfung reserviert.

Preisangebot vor der Generierung.

Angeforderte Sekunden × Auflösungspreis × geltender Faktor. Der angebotene Betrag wird beim Absenden reserviert, bei Erfolg abgebucht und bei Fehlschlag zurückgegeben.

Mit demselben Schlüssel herunterladen

Verwenden Sie nach succeeded content.video_url oder den Inhaltsendpunkt unten mit Ihrem API-Schlüssel. Ein Restguthaben von null verhindert den Download einer bereits bezahlten Aufgabe nicht.

Bei unklarer Übermittlung

Ein 202-Beleg mit needs_reconcile enthält weiterhin eine lokale Aufgaben-ID. Bewahren Sie diese ID auf und prüfen Sie sie. Erstellen Sie nicht automatisch eine weitere Aufgabe: Der ursprüngliche Betrag bleibt reserviert.