Auf dieser Seite
- Kurze Antwort
- Eine fehlgeschlagene Seedance-Anfrage debuggen
- Request-Fehler (der HTTP-Aufruf scheitert)
- Job-Fehler (der Job endet als fehlgeschlagen, Tokens freigegeben)
- Warum wurde meine Referenz abgelehnt?
- Warum hat das Ergebnis ein anderes Seitenverhältnis?
- Warum ist camera_fixed mit einer Bildeingabe fehlgeschlagen?
- Häufige Fragen
Kurze Antwort
Es gibt zwei Arten von Fehlern. Request-Fehler lassen den HTTP-Aufruf selbst scheitern (falsche Parameter, ungültiger Key, zu wenig Guthaben, Rate Limit), und es wird nichts reserviert. Job-Fehler beenden einen angenommenen Job als fehlgeschlagen, mit einem errorCode am Job, und seine reservierten Tokens werden freigegeben. Die Tabellen unten listen jeden Code mit der passenden Lösung.
Jetzt loslegen
Eine fehlgeschlagene Seedance-Anfrage debuggen
- 1
Lies den Code, nicht die Meldung
Verzweige nach code (Request-Fehler) oder job.errorCode (Job-Fehler); Meldungen können sich ändern, Codes nicht.
- 2
Zuerst die Limits prüfen
Die meisten 400er sind eine Dauer, Auflösung oder ein Seitenverhältnis, das das Modell nicht anbietet. GET /v1/models listet die Limits jedes Modells.
- 3
429 respektieren
Warte die Sekunden aus Retry-After ab, bevor du erneut sendest.
- 4
Sicher erneut senden
Nach einem Timeout sendest du mit demselben Idempotency-Key erneut. Nach einem abgelehnten Prompt änderst du ihn und nimmst einen neuen Key.
Request-Fehler (der HTTP-Aufruf scheitert)
| Code | Status | Bedeutung | Lösung |
|---|---|---|---|
| invalid_api_key | 401 | Der Key fehlt, ist falsch oder wurde widerrufen. | Sende Authorization: Bearer <key>. Erstelle einen neuen Key, falls er widerrufen wurde. |
| insufficient_balance | 402 | Nicht genug Tokens für die angebotenen Kosten. | Lade unter Billing auf. data.top_up_url verlinkt dorthin. |
| account_not_active | 403 | Das Entwicklerkonto ist gesperrt. | Wende dich an den Support. |
| scope_missing | 403 | Dem Key fehlt der Scope, den dieser Endpoint braucht. | Nutze einen Key mit diesem Scope. |
| job_not_found | 404 | Kein Job mit dieser ID im Konto dieses Keys. | Prüfe die ID; Jobs sind privat für das Konto. |
| character_not_found | 404 | Die Character-ID oder der Slug existiert nicht. | Liste Characters mit GET /v1/characters auf. |
| upload_not_found | 404 | Die upload_id existiert in diesem Workspace nicht. | Erstelle den Upload erneut. |
| reference_upload_not_found | 404 | Eine Referenz-upload_id existiert in diesem Workspace nicht. | Lade die Datei erneut hoch und nutze die neue upload_id. |
| video_edit_source_not_found | 404 | Die source_video_upload_id existiert nicht. | Lade den Clip mit upload_type VIDEO hoch. |
| upload_in_use | 409 | Ein wartender oder laufender Job nutzt diesen Upload noch. | Lösche ihn, wenn der Job fertig ist. |
| character_pending | 409 | Der Character wird noch geprüft. Es wurde nichts reserviert. | Warte retry_after Sekunden und sende dann erneut. |
| upload_too_large | 413 | Die Datei überschreitet das Größenlimit für ihren Typ. | Bilder 50 MB, Video 200 MB, Audio 15 MB. |
| character_registration_failed | 422 | Das Character-Bild hat die Prüfung nicht bestanden. | Registriere den Character erneut mit einem anderen Bild. |
| rate_limited | 429 | Zu viele Anfragen im Zeitfenster. | Warte die Sekunden aus dem Retry-After-Header ab. |
| prompt_required | 400 | Es wurde kein Prompt (oder bei Sprache kein Text) gesendet. | Füge einen Prompt hinzu. |
| prompt_too_long | 400 | Der Prompt überschreitet das Limit des Modells. | Kürze ihn; GET /v1/models nennt maxPromptChars. |
| model_not_found | 400 | Unbekannter Modell-Alias. | Nutze eine ID aus GET /v1/models. |
| duration_not_supported | 400 | Das Modell bietet diese Länge nicht an. | Sende eine der Laufzeiten des Modells. |
| aspect_ratio_not_supported | 400 | Das Modell bietet dieses Seitenverhältnis nicht an. | Sende eines der Seitenverhältnisse des Modells. |
| resolution_not_supported | 400 | Das Modell bietet diese Auflösung nicht an. | Sende eine der Auflösungen des Modells. |
| reference_combination_not_supported | 400 | Diese Referenzen lassen sich nicht kombinieren, z. B. Start-/Endframes mit Referenzbildern. | Sende eine Art pro Anfrage. |
| character_prompt_unsafe | 400 | Ein Character-Prompt verlangt, einer realen Person zu gleichen. | Beschreibe stattdessen Aussehen, Kleidung, Pose und Stil. |
| person_match_prompt_unsafe | 400 | Ein Referenz-Prompt verlangt, dem Gesicht oder Aussehen einer realen Person zu gleichen. | Registriere einen eigenen Character und beschreibe stattdessen den Look. |
| upload_invalid | 400 | Der Upload-Anfrage fehlt ein Feld oder sie hat einen falschen Typ. | Sende file_name, mime_type, file_size und upload_type. |
| video_edit_model_not_supported | 400 | Videobearbeitungen brauchen ein Modell der Seedance 2.0 Familie (2.0, Fast oder Mini). | Nutze kreator-video-pro, kreator-video-fast oder kreator-video-mini. |
| video_edit_source_required | 400 | Eine Videobearbeitung braucht einen Quellclip. | Sende source_video_upload_id oder video. |
| voice_required | 400 | Sprache braucht eine Stimme. | Nutze eine ID aus GET /v1/voices. |
| internal_error | 500 | Auf unserer Seite ist etwas schiefgegangen. | Sende erneut mit demselben Idempotency-Key. |
| dispatch_disabled | 503 | Die Generierung ist für diese Umgebung pausiert. | Versuche es später erneut. |
Job-Fehler (der Job endet als fehlgeschlagen, Tokens freigegeben)
| Code | Bedeutung | Lösung |
|---|---|---|
| reference_rejected | Eine Referenz wurde abgelehnt (oft das Foto einer realen Person). | Registriere das Gesicht als Character oder nutze ein anderes Bild. |
| reference_asset_pending | Eine neue Referenz wird noch geprüft. | Warte errorData.retry_after Sekunden und sende erneut mit derselben upload_id und einem neuen Idempotency-Key. |
| reference_asset_failed | Die Referenz hat die Prüfung nicht bestanden. | Nutze eine andere Datei. |
| generation_rejected | Die Anfrage wurde abgelehnt (Prompt, Referenz oder Optionen). | Ändere Prompt, Referenz oder Optionen und sende dann erneut. |
| generation_timeout | Der Job wurde nicht rechtzeitig fertig. Reservierte Tokens werden freigegeben. | Sende erneut mit einem neuen Idempotency-Key. |
| generation_unavailable | Das Modell ist vorübergehend nicht verfügbar. | Versuche es später erneut oder wähle ein anderes Modell. |
| generation_failed | Die Generierung ist fehlgeschlagen. | Sende erneut; ändere Prompt oder Referenzen, falls es wieder passiert. |
Warum wurde meine Referenz abgelehnt?
Referenzen und Prompts, die einer realen Person, einem Promi oder einer Person des öffentlichen Lebens gleichen sollen, werden abgelehnt. Das gilt für Fotos realer Personen als Referenz und für Prompts, die eine Person zum Nachahmen nennen. Beschreibe stattdessen Aussehen, Kleidung und Stil, oder registriere mit POST /v1/characters einen Character, der dir gehört, und übergib seine ID.
Warum hat das Ergebnis ein anderes Seitenverhältnis?
Mit einem Eingabebild oder ersten Frame folgt adaptive dem Bild. Sende ein explizites aspect_ratio, wenn das Ergebnis zu einem Format passen muss, und prüfe, ob das Modell es anbietet.
Warum ist camera_fixed mit einer Bildeingabe fehlgeschlagen?
Lass camera_fixed weg, wenn du ein Bild oder einen Frame als Eingabe sendest, und beschreibe die Kamera stattdessen im Prompt (zum Beispiel locked-off camera).
Häufige Fragen
Zahle ich, wenn ein Seedance-Job fehlschlägt?
Nein. Die reservierten Tokens eines fehlgeschlagenen Jobs werden freigegeben.
Was bedeutet insufficient_balance?
Dein Token-Guthaben ist niedriger als der angebotene Preis des Jobs. Lade in der Konsole auf; es wurde nichts reserviert.
Was mache ich bei einem 429?
Warte die Anzahl Sekunden aus dem Retry-After-Header ab und sende dann erneut.
Warum wurde mein Prompt abgelehnt?
Er sollte einer realen Person gleichen oder hat gegen die Richtlinie zur zulässigen Nutzung verstoßen. Ändere den Prompt und erstelle einen neuen Job.
