Seedance-Reihe

Die Videogenerierungsmodelle von ByteDance, insgesamt vier, aufgerufen über den OfoxAI-Videoendpunkt POST /v1/videos. Aufgaben laufen asynchron: Nach dem Erstellen erhalten Sie eine Aufgaben-ID, über die Sie anschließend das Ergebnis abfragen.

Modellwahl

Alle vier unterstützen Text-zu-Video, Bild-zu-Video und Videoreferenzen und können eine synchrone Tonspur erzeugen (generate_audio ist standardmäßig true). adaptive übernimmt das Seitenverhältnis des Eingabebilds.

Die Tabelle entspricht den video_attributes, die die Models API zurückgibt; ändern sich die Fähigkeiten eines Modells, ist die Antwort der API maßgeblich. Abgerechnet wird pro Sekunde; die tatsächlichen Kosten stehen in usage.video_cost des Aufgabenergebnisses. Preise finden Sie auf der Modellseite .

Aufrufbeispiele

Die folgenden Beispiele zeigen nur die Anfrage zum Erstellen der Aufgabe. Den vollständigen Ablauf mit Statusabfrage und Download des Ergebnisses finden Sie unter Video API · Schnellstart.

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0-mini",
    "prompt": "Ein Fuchs rennt durch den Schnee, die Kamera folgt ihm",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "Der Hund im Bild rennt auf die Kamera zu",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/dog.jpg" }, "frame_type": "first_frame" }
    ]
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "Eine Knospe öffnet sich langsam zu einer voll erblühten Rose",
    "duration": 5,
    "resolution": "720p",
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/bud.jpg" }, "frame_type": "first_frame" },
      { "type": "image_url", "image_url": { "url": "https://example.com/rose.jpg" }, "frame_type": "last_frame" }
    ]
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.5",
    "prompt": "Das Mädchen aus Bild 1 hält die Tasse aus Bild 2 und lächelt am Fenster eines Cafés",
    "duration": 5,
    "resolution": "720p",
    "input_references": [
      { "type": "image_url", "image_url": { "url": "https://example.com/girl.jpg" } },
      { "type": "image_url", "image_url": { "url": "https://example.com/cup.jpg" } }
    ]
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "Die Figur spricht im Tonfall dieser Sprachaufnahme, die Kameraführung orientiert sich an diesem Video",
    "duration": 5,
    "resolution": "720p",
    "input_references": [
      { "type": "image_url", "image_url": { "url": "https://example.com/character.jpg" } },
      { "type": "audio_url", "audio_url": { "url": "https://example.com/voice.mp3" } },
      { "type": "video_url", "video_url": { "url": "https://example.com/style-ref.mp4" } }
    ]
  }'

• frame_images und input_references dürfen nicht gemeinsam übergeben werden; andernfalls wird 400 references_conflict zurückgegeben.
• Bilder können als öffentliche URL oder als Zeichenkette mit dem Präfix data:image/...;base64, übergeben werden.
• Wenn Sie keine Tonspur benötigen, übergeben Sie "generate_audio": false.
• Die vollständige Beschreibung der Feldstruktur finden Sie unter Videoaufgabe erstellen.

Referenzbilder realer Personen

Die offizielle Seedance-API von ByteDance erlaubt kein direktes Hochladen von Referenzbildern oder -videos mit realen Gesichtern. Die offizielle BytePlus-Dokumentation zu Seedance 2.0  verlangt autorisierte Personen-Assets; der Volcano-Ark-Leitfaden zur Personenbibliothek  nennt die Schritte Einladung versenden, Verifizierung und Freigabe durch die Person, Material hochladen, Freigabe annehmen und Asset-ID abrufen.

{
  "model": "bytedance/seedance-2.0",
  "prompt": "Die Person im Bild geht über einen filmisch wirkenden Nachtmarkt",
  "duration": 5,
  "resolution": "720p",
  "real_person": true,
  "input_references": [
    { "type": "image_url", "image_url": { "url": "https://example.com/person.jpg" } }
  ]
}

• OfoxAI verarbeitet Referenzbilder vor dem Absenden datenschutzwahrend vor. Das kann Fehlablehnungen durch die Anti-Deepfake-Prüfung des Upstream-Anbieters verringern, garantiert aber keine Annahme; vom Upstream-Anbieter abgelehnte Aufgaben werden nicht berechnet.
• real_person ist eine Verarbeitungsanweisung, kein Nachweis der Einwilligung. Senden Sie nur Bilder, die Sie rechtmäßig und mit Einwilligung verwenden dürfen.
• Wie Sie Bilder anpassen, die weiterhin abgelehnt werden, und welche Fehlercodes die Vorverarbeitung liefert, steht unter Referenzbilder realer Personen.

Anbieter festlegen

Um einen Anbieter festzulegen, fügen Sie auf oberster Ebene der Anfrage hinzu:

"provider": { "type": "byteplus" }

Ein ungültiger Wert für provider.type liefert 400 invalid_provider_type; stellt der angegebene Anbieter das Modell nicht bereit, wird 400 provider_type_unavailable zurückgegeben. Allgemeine Hinweise finden Sie unter Provider-Routing für Videos.

Häufige Fehler

Schlägt eine erfolgreich erstellte Aufgabe während der Generierung fehl, liefert die Abfrage status: "failed"; die Ursache steht im Feld error, ein Timeout entspricht error.code: "expired". Alle Fehlercodes finden Sie unter Fehlercodes der Video API.

Offizielle Dokumentation

• BytePlus Seedance 2.0 Video Generation API 
• Volcano Engine Ark Dokumentationszentrum 
• OfoxAI · Videoaufgabe erstellen

FAQ