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_developer | 400 | The upload_id is a file uploaded on the website, not through the API. | Upload this file with /v1/uploads first. |
| 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. |
| 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. |
| paid_account_required | 403 | Lip Sync needs a paid account. Nothing was charged. | Top up with a card under Billing. |
| paid_check_unavailable | 503 | The account's payment status could not be read just now. Nothing was charged. | Send the same request again in a moment. |
| audio_reference_too_long | 400 | The audio references add up to more than the model accepts in total (15 s on Seedance 2.0, 30 s on 2.5). Nothing was charged. | Trim or remove audio so all audio references combined fit. |
| image_upload_not_found | 404 | The image_upload_id isn't in this workspace. | Upload the photo with upload_type IMAGE and use the new upload_id. |
| audio_upload_not_found | 404 | The audio_upload_id isn't in this workspace (or audio_job_id isn't a completed /v1/audio job). | Upload the track with upload_type AUDIO, or use a completed audio job id. |
| audio_too_short | 400 | The voice track is under 4 seconds. Nothing was charged. | Send 4 seconds to 5 minutes of audio. |
| audio_too_long | 400 | The voice track is over 5 minutes. Nothing was charged. | Trim it to 5 minutes or less. |
| audio_unreadable | 400 | The audio couldn't be read. Nothing was charged. | Use an MP3 or WAV under 15 MB. |
| image_rejected | 422 | The photo didn't pass the safety check. Nothing was charged. | Use a different photo. |
| 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.
