TL;DR
Die Seedance 2.0 API wurde am 2. April 2026 über Volcengine Ark gestartet. Sie übermitteln eine Videoerstellungsaufgabe mit einer POST-Anfrage und fragen dann einen GET-Endpunkt ab, bis der Status "succeeded" erreicht ist. Die API unterstützt Text-zu-Video, Bild-zu-Video, Steuerung des ersten und letzten Frames, multimodale Referenzen und native Audioerzeugung. Ein 5-sekündiges 1080p-Video kostet etwa 0,93 $. Laden Sie das Video innerhalb von 24 Stunden herunter. Die URL läuft danach ab.
Hypereal AI
Einleitung
Am 2. April 2026 veröffentlichte ByteDance's Volcengine Ark Plattform die offizielle Seedance 2.0 API. Vor diesem Datum war die einzige Möglichkeit, Seedance 2.0 Videos zu erstellen, über die Webkonsole. Wenn Sie Tutorials gesehen haben, die eine UI-Durchführung zeigen, waren diese für die Konsole geschrieben. Dieser Leitfaden behandelt die eigentliche API, die Entwickler programmatisch aufrufen können.
Dieser Artikel behandelt jeden unterstützten Eingabetyp, die Preisberechnung anhand der Token-Anzahl der Antwort und die Fehler, die Ihnen in der Produktion begegnen werden.
Was ist Seedance 2.0?
Seedance 2.0 ist ein Videogenerierungsmodell von ByteDance. Es läuft auf Volcengine Ark unter den Modell-IDs doubao-seedance-2-0-260128 (Standard) und doubao-seedance-2-0-fast-260128 (schneller, geringere Qualität).
Das Modell unterstützt mehr Eingabetypen als Version 1.5. Version 1.5 verarbeitete Text-zu-Video und Bild-zu-Video. Version 2.0 fügt hinzu:
- Steuerung des ersten und letzten Frames (Sie liefern beide Rahmenbilder)
- Multimodale Referenzeingaben: Bilder, Videoclips und Audiodateien kombiniert in einer Anfrage
- Native Audioerzeugung, einschließlich Dialog, Soundeffekten, Umgebungsgeräuschen und Musik
- Lippensynchronisation in über 8 Sprachen
- Kamerabewegungssteuerung durch natürliche Sprachbefehle (Dolly, Tracking, Kranfahrten)
- Ausgabe von bis zu 15 Sekunden Länge mit bis zu 2K Auflösung
Das Modell gibt Videos mit 24 Bildern pro Sekunde und Seitenverhältnissen von 1:1 bis 21:9 aus. Sie wählen die Auflösung zum Zeitpunkt der Anfrage.
Was sich geändert hat: Leitfaden vs. offizielle API
Frühere Artikel über Seedance 2.0, darunter ein Leitfaden vom Februar 2026 auf dieser Website, beschrieben die Seedance 2.0 Webkonsole auf Volcengine. Zu diesem Zeitpunkt existierte keine API. Diese Leitfäden zeigten, wie man ein Prompt-Feld auf einer Webseite ausfüllt und auf einen Generieren-Button klickt.
Die API-Veröffentlichung vom 2. April 2026 ändert dies grundlegend. Sie können die API nun von jeder Sprache aus aufrufen, Videogenerierungs-Pipelines automatisieren und Seedance in Ihr eigenes Produkt integrieren. Dieser Leitfaden ersetzt die UI-Anleitung für jeden Entwickler-Anwendungsfall.
Voraussetzungen
Sie benötigen ein Volcengine-Konto, um zu beginnen. Erstellen Sie eines unter volcengine.com. Sobald Ihr Konto aktiv ist, gehen Sie zur Ark-Konsole unter:
https://console.volcengine.com/ark/region:ark+cn-beijing/apikey
Generieren Sie dort einen API-Schlüssel. Exportieren Sie ihn dann als Umgebungsvariable:
export ARK_API_KEY="your-api-key-here"
Jede Anfrage an die API verwendet diesen Schlüssel in einem Bearer-Token-Header:
Authorization: Bearer YOUR_ARK_API_KEY
Neue Konten erhalten kostenlose Testguthaben. Diese decken etwa 8 vollständige 15-sekündige Generierungen in 1080p ab, bevor Sie etwas bezahlen.
Text-zu-Video: Ihre erste Anfrage
Die Basis-URL für alle Seedance API-Aufrufe ist:
https://ark.cn-beijing.volces.com/api/v3
Um eine Text-zu-Video-Aufgabe zu übermitteln, senden Sie einen POST-Request an /v1/contents/generations/tasks.
cURL-Beispiel
curl -X POST "https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ARK_API_KEY" \
-d '{
"model": "doubao-seedance-2-0-260128",
"content": [
{
"type": "text",
"text": "A golden retriever running through a sunlit wheat field, wide tracking shot, cinematic"
}
],
"resolution": "1080p",
"ratio": "16:9",
"duration": 5,
"watermark": false
}'
Die API gibt sofort eine Aufgaben-ID zurück:
{"id": "cgt-2025xxxxxxxx-xxxx"}
Python-Beispiel (offizielles SDK)
Installieren Sie zuerst das SDK:
pip install volcenginesdkarkruntime
Senden Sie dann eine Aufgabe:
import os
from volcenginesdkarkruntime import Ark
client = Ark(api_key=os.environ.get("ARK_API_KEY"))
resp = client.content_generation.tasks.create(
model="doubao-seedance-2-0-260128",
content=[
{
"type": "text",
"text": "A golden retriever running through a sunlit wheat field, wide tracking shot, cinematic"
}
],
resolution="1080p",
ratio="16:9",
duration=5,
watermark=False,
)
print(resp.id)
Speichern Sie die Aufgaben-ID. Sie werden sie für den Abfrageschritt benötigen.
Das asynchrone Aufgabenmuster: senden, abfragen, herunterladen
Die Seedance-Generierung ist nicht sofort. Ein 5-sekündiges 1080p-Video dauert typischerweise 60 bis 120 Sekunden. Die API handhabt dies mit einem asynchronen Aufgabenlebenszyklus:
queued -> running -> succeeded
-> failed
-> expired
-> cancelled
Sie fragen den GET-Endpunkt ab, bis sich der Status von queued oder running ändert.
Vollständige Python-Abfrageschleife
import os
import time
import requests
from volcenginesdkarkruntime import Ark
client = Ark(api_key=os.environ.get("ARK_API_KEY"))
# Schritt 1: Übermitteln
resp = client.content_generation.tasks.create(
model="doubao-seedance-2-0-260128",
content=[
{"type": "text", "text": "Aerial shot of a mountain lake at sunrise, slow dolly forward"}
],
resolution="1080p",
ratio="16:9",
duration=5,
watermark=False,
)
task_id = resp.id
print(f"Task submitted: {task_id}")
# Schritt 2: Abfragen mit exponentiellem Backoff
wait = 10
while True:
result = client.content_generation.tasks.get(task_id=task_id)
status = result.status
print(f"Status: {status}")
if status == "succeeded":
video_url = result.content.video_url
print(f"Video URL: {video_url}")
break
elif status in ("failed", "expired", "cancelled"):
print(f"Task ended with status: {status}")
break
time.sleep(wait)
wait = min(wait * 2, 60) # auf 60 Sekunden begrenzen
# Schritt 3: Sofort herunterladen
if status == "succeeded":
response = requests.get(video_url, stream=True)
with open("output.mp4", "wb") as f:
for chunk in response.iter_content(chunk_size=8192):
f.write(chunk)
print("Heruntergeladen: output.mp4")
Der exponentielle Backoff verhindert eine Überlastung der API. Die Begrenzung auf 60 Sekunden sorgt dafür, dass die Abfrage für den praktischen Gebrauch häufig genug erfolgt.
Bild-zu-Video (I2V): Animieren eines Standbildes
Um ein Bild zu animieren, fügen Sie ein image_url-Objekt zum content-Array neben Ihrer Textaufforderung hinzu. Das Bild wird zum ersten Frame des Videos.
resp = client.content_generation.tasks.create(
model="doubao-seedance-2-0-260128",
content=[
{
"type": "text",
"text": "The woman slowly turns her head and smiles at the camera"
},
{
"type": "image_url",
"image_url": {"url": "https://example.com/portrait.jpg"}
}
],
ratio="adaptive",
duration=5,
watermark=False,
)
Wenn Sie ratio auf "adaptive" setzen, weist dies das Modell an, das native Seitenverhältnis des Eingabebildes zu verwenden. Dies vermeidet unerwünschtes Zuschneiden oder Letterboxing.
Jedes Bild muss unter 30 MB groß sein. Sie können bis zu 9 Bilder in einer einzigen Anfrage bereitstellen.
Erster und letzter Frame: Steuerung von Start- und Endpunkten
Seedance 2.0 unterstützt die Steuerung von Anfangs- und Endframes. Sie liefern das Bild des ersten Frames, das Bild des letzten Frames und eine Textaufforderung. Das Modell generiert die Bewegung dazwischen.
Dies ist nützlich für Produktübergänge, Morphing-Effekte oder jede Sequenz, bei der Sie Ihre Start- und Endzustände kennen.
resp = client.content_generation.tasks.create(
model="doubao-seedance-2-0-260128",
content=[
{
"type": "text",
"text": "The flower blooms from bud to full open, macro lens, soft light"
},
{
"type": "image_url",
"image_url": {"url": "https://example.com/flower-bud.jpg"}
},
{
"type": "image_url",
"image_url": {"url": "https://example.com/flower-open.jpg"}
}
],
ratio="adaptive",
duration=8,
watermark=False,
)
Das Modell leitet ab, dass zwei Bilder den Anfangs- und Endframe-Modus bedeuten, wenn auch eine Textaufforderung vorhanden ist. Fügen Sie beide Bilder in der richtigen Reihenfolge ein: zuerst den ersten Frame, dann den letzten Frame.
Sie können auch return_last_frame: true verwenden, wenn Sie einen Clip generieren. Dies gibt ein Bild des letzten Frames zusammen mit der Video-URL zurück. Speisen Sie dieses Bild als ersten Frame Ihrer nächsten Anfrage ein, um mehrere Clips zu einer längeren Sequenz zu verketten.
Multimodale Referenz: Kombination von Bildern, Video und Audio
Eine der stärksten Ergänzungen in Seedance 2.0 ist die Akzeptanz von Video und Audio als Referenzeingaben in derselben Anfrage wie Bilder und Text.
Das Content-Array kann enthalten:
{"type": "text", "text": "..."}für die Aufforderung{"type": "image_url", "image_url": {"url": "..."}}für Bilder{"type": "video_url", "video_url": {"url": "..."}}für Videoreferenzen{"type": "audio_url", "audio_url": {"url": "..."}}für Audioreferenzen
Grenzwerte pro Anfrage:
- Bis zu 9 Bilder (max. 30MB pro Bild)
- Bis zu 3 Videoclips (jeweils 2 bis 15 Sekunden, max. 50MB pro Clip)
- Bis zu 3 Audiodateien (MP3, max. 15MB pro Datei)
Ein Beispiel für eine kombinierte Referenz:
resp = client.content_generation.tasks.create(
model="doubao-seedance-2-0-260128",
content=[
{
"type": "text",
"text": "Match the visual style of the reference clip and add the provided background audio"
},
{
"type": "image_url",
"image_url": {"url": "https://example.com/style-reference.jpg"}
},
{
"type": "video_url",
"video_url": {"url": "https://example.com/motion-reference.mp4"}
},
{
"type": "audio_url",
"audio_url": {"url": "https://example.com/background-music.mp3"}
}
],
duration=10,
ratio="16:9",
watermark=False,
)
Wenn Sie eine Videoreferenz einbeziehen, sinkt der Abrechnungssatz auf die V2V-Stufe: etwa 3,90 $ pro Million Token anstelle von 6,40 $.
Native Audioerzeugung
Setzen Sie generate_audio: true, damit Seedance eine Audiospur zusammen mit dem Video generiert. Das Modell führt eine gemeinsame Audio-Video-Generierung durch, sodass die Töne zur Aktion auf dem Bildschirm passen, anstatt nachträglich überlagert zu werden.
Die Audioerzeugung umfasst Dialoge, Soundeffekte, Umgebungsgeräusche und Hintergrundmusik. Lippensynchronisation funktioniert in über 8 Sprachen.
resp = client.content_generation.tasks.create(
model="doubao-seedance-2-0-260128",
content=[
{
"type": "text",
"text": "A street musician plays guitar outside a cafe in Paris, crowds passing by, city sounds"
}
],
resolution="1080p",
ratio="16:9",
duration=10,
generate_audio=True,
watermark=False,
)
Die native Audioerzeugung erhöht den Token-Verbrauch im Vergleich zu lautlosem Video leicht. Berücksichtigen Sie dies in Ihren Kostenschätzungen.
Auflösung, Seitenverhältnis und Dauer steuern
Drei Parameter prägen die Ausgabe:
resolution akzeptiert "480p", "720p", "1080p" oder "2K". Der Standardwert ist "1080p". Eine höhere Auflösung bedeutet mehr verbrauchte Token und höhere Kosten.
ratio akzeptiert "16:9", "9:16", "4:3", "3:4", "21:9", "1:1" oder "adaptive". Verwenden Sie "adaptive", wenn Ihr Eingabebild ein ungewöhnliches Seitenverhältnis hat. Das Modell liest die Bildabmessungen und stellt das Seitenverhältnis entsprechend ein.
duration akzeptiert Ganzzahlen von 4 bis 15. Die Einheit sind Sekunden. Der Standardwert ist 5. Längere Videos kosten proportional mehr.
Das schnelle Modell (doubao-seedance-2-0-fast-260128) generiert mit geringerer Qualität, ist aber schneller fertig. Verwenden Sie es für Prototyping oder wenn Sie Aufforderungen iterieren. Wechseln Sie zum Standardmodell für die Produktion.
Wann Seedance 2.0 anderen Video-APIs vorzuziehen ist: Wählen Sie Seedance, wenn Sie native Audio-Video-Ko-Generierung, Anfangs- und Endframe-Steuerung oder multimodale Referenzeingaben benötigen. Wenn Sie nur einfaches Text-zu-Video benötigen und die Kosten Priorität haben, ist das schnelle Modell bei 480p die günstigste Option in dieser Klasse.
Kosten aus der Antwort ablesen
Nachdem eine Aufgabe erfolgreich war, enthält die Antwort ein usage-Feld:
{
"usage": {
"completion_tokens": 246840,
"total_tokens": 246840
}
}
Der Token-Verbrauch korreliert mit Videolänge und Auflösung. Ein Referenzpunkt aus der offiziellen Dokumentation: Ein 15-sekündiges 1080p-Video verbraucht ungefähr 308.880 Token. Ein 5-sekündiges 1080p-Video verwendet etwa 102.960 Token.
Die Preisgestaltung für T2V und I2V in 1080p beträgt 46 Yuan pro Million Token (etwa 6,40 $ pro Million Token zum aktuellen Wechselkurs).
Schnelle Schätzungen:
- 5-sekündiges 1080p-Video: ca. 102.960 Token = ca. 0,47 Yuan = ca. 0,93 $
- 10-sekündiges 1080p-Video: ca. 205.920 Token = ca. 9,47 Yuan = ca. 1,97 $
Für V2V-Aufgaben (Anfragen, die eine Videoreferenz enthalten) sinkt der Satz auf 28 Yuan pro Million Token (etwa 3,90 $ pro Million Token).
Sie können die genaue Token-Anzahl in jeder Antwort überprüfen und die Kostenverfolgung in Ihre Anwendung integrieren. Multiplizieren Sie completion_tokens mit dem Satz für Ihren Aufgabentyp.
Wichtig: Video innerhalb von 24 Stunden herunterladen
Die video_url in einer erfolgreichen Antwort verweist auf den Objektspeicher von Volcengine. Diese URL läuft 24 Stunden nach erfolgreichem Abschluss der Aufgabe ab. Danach gibt die URL einen 403-Fehler zurück und die Datei ist verschwunden.
Laden Sie die Datei immer sofort in Ihren eigenen Speicher herunter, nachdem sich der Status in succeeded geändert hat. Die Abfrageschleife im vorherigen Abschnitt enthält diesen Download-Schritt als Teil des Standardablaufs.
Das Feld execution_expires_after bestätigt das Ablaufintervall in Sekunden. 172800 bedeutet 48 Stunden für den Aufgaben-Eintrag selbst. Die Video-URL läuft jedoch immer noch nach 24 Stunden ab. Vertrauen Sie der 24-Stunden-Regel.
Die Aufgabenhistorie ist ebenfalls auf die letzten 7 Tage beschränkt. Sie können keine Aufgaben abfragen, die älter sind.
So testen Sie die Seedance API mit Apidog
Das asynchrone Aufgabenmuster besteht aus zwei voneinander abhängigen API-Aufrufen. Sie können dafür keinen Einzelanfragen-Test schreiben. Die Test-Szenarien von Apidog handhaben dies mit einem verketteten Ablauf.
Hier ist die genaue Einrichtung:
Schritt 1: Ein Test-Szenario erstellen
Gehen Sie in Apidog zum Modul Tests und erstellen Sie ein neues Szenario namens "Seedance 2.0 Video-Generierung". Setzen Sie Ihre Umgebungsvariable ARK_API_KEY in den Apidog-Umgebungseinstellungen. Verwenden Sie {{ARK_API_KEY}}, wo immer Sie den Schlüssel referenzieren würden.
Schritt 2: Die Übermittlungsanfrage hinzufügen
Fügen Sie einen benutzerdefinierten POST-Anforderungsschritt zu https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks hinzu. Setzen Sie den Authorization-Header auf Bearer {{ARK_API_KEY}}. Fügen Sie Ihren JSON-Body mit den Modell- und Inhaltsfeldern hinzu.
Fügen Sie nach diesem Schritt einen Extrakt-Variablen-Prozessor hinzu. Konfigurieren Sie ihn so, dass er aus dem Antwortbody mittels des JSONPath-Ausdrucks $.id extrahiert. Speichern Sie den Wert in einer Umgebungsvariablen namens TASK_ID.
Schritt 3: Einen Warte-Prozessor hinzufügen
Fügen Sie nach dem Extraktionsschritt einen Warte-Prozessor ein. Stellen Sie die Verzögerung auf 30 Sekunden ein. Dies gibt dem Modell Zeit, mit der Verarbeitung zu beginnen, bevor Sie die erste Abfrage versuchen.
Schritt 4: Die Abfrageanfrage in einer For-Schleife hinzufügen
Fügen Sie einen For-Schleifen-Kontrollblock mit maximal 20 Iterationen hinzu. Innerhalb der Schleife:
- Fügen Sie einen GET-Anforderungsschritt zu
https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/{{TASK_ID}}mit demselben Authorization-Header hinzu. - Fügen Sie nach der GET-Anfrage einen Warte-Prozessor mit einer Verzögerung von 10 Sekunden hinzu.
- Legen Sie die Abbruchbedingung der Schleife fest:
$.status == "succeeded"oder$.status == "failed".
Schritt 5: Assertions hinzufügen
Nachdem die Schleife beendet ist, fügen Sie einen Assertions-Prozessor hinzu, der überprüft:
$.statusist gleich"succeeded"$.content.video_urlist nicht leer
Führen Sie das Szenario aus und Apidog generiert einen vollständigen Testbericht, der jeden Schritt, die extrahierte Aufgaben-ID, alle Abfrageantworten und ob die endgültigen Assertions bestanden wurden, zeigt.
Sie können die Seedance-Endpunkte auch direkt aus einem cURL-Befehl in die Test-Szenarioschritte importieren. Dieser Ansatz funktioniert gut, wenn Sie die Übermittlungs- und Abfrageanfragen schnell hinzufügen möchten, ohne jeden Header und Parameter manuell eingeben zu müssen.
Preisaufschlüsselung: Was ein 10-sekündiges Video kostet
Die Seedance API verwendet eine Pay-as-you-go-Token-Preisgestaltung. Es gibt keine monatlichen Lizenzen oder Guthaben zu verwalten, abgesehen vom anfänglichen Testguthaben.
| Aufgabentyp | Rate (pro 1 Mio. Token) |
|---|---|
| T2V / I2V bei 1080p | 46 Yuan (~$6.40) |
| V2V (Video-Referenz-Eingabe) | 28 Yuan (~$3.90) |
Ungefähre Kosten für gängige Dauern bei 1080p:
| Dauer | Ungefähre Token | Kosten (T2V/I2V) |
|---|---|---|
| 5 Sekunden | ~103.000 | ~$0.66 Yuan / ~$0.93 |
| 10 Sekunden | ~206.000 | ~$9.48 Yuan / ~$1.32 |
| 15 Sekunden | ~309.000 | ~$14.21 Yuan / ~$1.97 |
Neue Konten beginnen mit kostenlosen Testguthaben, die etwa 8 vollständige 15-sekündige Generierungen abdecken. Nutzen Sie dieses Kontingent, um mit Aufforderungen und Einstellungen zu experimentieren, bevor Sie sich zu einer Produktionsauslastung verpflichten.
Eine geringere Auflösung reduziert den Token-Verbrauch erheblich. Ein 480p-Video mit der gleichen Dauer kostet erheblich weniger als ein 1080p-Video. Beginnen Sie die Entwicklung bei 720p und aktualisieren Sie die Auflösung nur für Ihre endgültige Ausgabe.
Häufige Fehler und Lösungen
429 Too Many Requests
Dies bedeutet, dass Sie das Gleichzeitigkeitslimit erreicht haben, nicht eine Ratenbegrenzung für Anfragen pro Minute. Es laufen zu viele Aufgaben gleichzeitig. Verwenden Sie einen exponentiellen Backoff, wenn Sie diesen Statuscode sehen. Beginnen Sie mit einer 10-sekündigen Wartezeit und verdoppeln Sie diese bei jedem erneuten Versuch, begrenzt auf 60 Sekunden. Die zuvor gezeigte Abfrageschleife enthält dieses Muster.
status: "failed"
Eine fehlgeschlagene Aufgabe bedeutet, dass das Modell das Video nicht generieren konnte. Häufige Ursachen: Die Aufforderung enthielt Inhalte, die Sicherheitsfilter verletzten, das Eingabebild war beschädigt oder zu groß, oder die Kombination von Parametern war ungültig. Überprüfen Sie Ihre Eingabedateien und die Aufforderung und senden Sie sie dann erneut.
status: "expired"
Eine Aufgabe läuft ab, wenn sie zu lange in der Warteschlange bleibt, ohne abgeschlossen zu werden. Dies kann während Spitzenlastzeiten geschehen. Senden Sie die Aufgabe erneut. Es gibt keine Möglichkeit, eine abgelaufene Aufgabe neu zu starten.
403 bei video_url
Die URL ist abgelaufen. Das 24-Stunden-Fenster ist abgelaufen, bevor Sie die Datei heruntergeladen haben. Der Aufgaben-Eintrag kann in der API noch bis zu 7 Tage existieren, aber die Videodatei ist verschwunden. Sie müssen sie mit denselben Parametern und demselben Seed-Wert neu generieren, falls Sie diesen gespeichert haben.
Reproduzierbarkeit des Seeds
Wenn Sie den seed-Wert aus einer vorherigen Antwort gespeichert haben, übergeben Sie ihn in der nächsten Anfrage mit denselben Parametern zurück. Das Modell wird versuchen, dieselbe Ausgabe zu reproduzieren. Dies ist nützlich, um abgelaufene Videos mit identischen Ergebnissen neu zu generieren.
Fazit
Die Seedance 2.0 API bietet Ihnen programmatischen Zugriff auf eines der leistungsfähigsten heute verfügbaren Videogenerierungsmodelle. Das asynchrone Aufgabenmuster ist unkompliziert: POST, um eine Aufgabe zu erstellen, abfragen bis zum Erfolg, sofort herunterladen. Die multimodalen Eingaben, die native Audioerzeugung und die Steuerung von Anfangs- und Endframes ermöglichen den Aufbau von Video-Workflows, die von einer Webkonsole aus unmöglich waren.
Richten Sie Ihre Testabdeckung in Apidog ein, bevor Sie in Produktion gehen. Die Test-Szenariokette fängt fehlerhafte Abfragelogik, fehlende Extraktionsschritte und URL-Ablaufprobleme ab, bevor sie echte Benutzer betreffen.
FAQ
F: Was ist der Unterschied zwischen doubao-seedance-2-0-260128 und doubao-seedance-2-0-fast-260128?
A: Das Standardmodell erzeugt eine höhere Ausgabequalität und ist die Standardeinstellung für die Produktion. Das schnelle Modell erledigt Aufgaben schneller mit geringerer visueller Qualität. Verwenden Sie das schnelle Modell beim Iterieren von Aufforderungen und wechseln Sie für die endgültigen Renderings zum Standard.
F: Kann ich Seedance 2.0 außerhalb Chinas nutzen?
A: Der API-Endpunkt wird in der Region Peking gehostet. Entwickler außerhalb Chinas können ihn aufrufen, aber die Latenz wird höher sein. Überprüfen Sie die Nutzungsbedingungen von Volcengine auf geografische Einschränkungen für Ihren Kontotyp.
F: Wie verketten ich mehrere Clips zu einem längeren Video?
A: Setzen Sie return_last_frame: true bei jeder Generierung. Die Antwort enthält ein Bild des letzten Frames zusammen mit der Video-URL. Übergeben Sie dieses Bild als ersten Frame Ihrer nächsten Anfrage. Wiederholen Sie dies, bis Sie alle benötigten Clips haben, und fügen Sie diese dann mit einer Videobearbeitungsbibliothek zusammen.
F: Kostet die native Audioerzeugung mehr?
A: Die native Audioerzeugung erhöht den Token-Verbrauch geringfügig, da das Modell eine gemeinsame Audio-Video-Generierung und nicht nur Video generiert. Erwarten Sie eine moderate Erhöhung der completion_tokens im Vergleich zur gleichen Anfrage ohne generate_audio: true.
F: Kann ich einen Webhook anstelle von Polling verwenden?
A: Ja. Übergeben Sie einen callback_url-Parameter in Ihrer Übermittlungsanfrage. Die API wird das Ergebnis der abgeschlossenen Aufgabe an diese URL POSTen, wenn sich der Status ändert. Dies ist effizienter als das Abfragen für Hochvolumen-Pipelines.
F: Was passiert, wenn ich das Limit von 9 Bildern überschreite?
A: Die API gibt einen 400 Validierungsfehler zurück, bevor die Aufgabe erstellt wird. Reduzieren Sie die Anzahl der Bilder in Ihrem content-Array auf 9 oder weniger.
F: Garantiert der Seed-Parameter die exakte Reproduktion desselben Videos?
A: Der Seed-Parameter macht Ausgaben reproduzierbarer. Eine exakte Reproduktion ist nicht garantiert, wenn Parameter abweichen oder serverseitige Modellversionen geändert werden. Es ist die bestmögliche Annäherung, die verfügbar ist.
F: Wie verfolge ich die Ausgaben über mehrere Aufgaben hinweg?
A: Lesen Sie das completion_tokens-Feld aus der Antwort jeder Aufgabe aus und multiplizieren Sie es mit dem Token-Satz Ihrer Stufe. Protokollieren Sie diese Werte in einer Datenbank zur Kostenverfolgung. Es gibt kein integriertes Ausgaben-Dashboard in der API, daher sollten Sie Ihre eigene Verfolgung von Anfang an aufbauen.