En esta página
- Respuesta corta
- Depura una solicitud fallida de Seedance
- Errores de solicitud (falla la llamada HTTP)
- Errores de trabajo (el trabajo termina como fallido y se liberan los tokens)
- ¿Por qué se rechazó mi referencia?
- ¿Por qué el resultado tiene otra relación de aspecto?
- ¿Por qué falló camera_fixed con una imagen de entrada?
- Preguntas frecuentes
Respuesta corta
Hay dos tipos de errores. Los errores de solicitud hacen fallar la propia llamada HTTP (parámetros incorrectos, clave inválida, saldo insuficiente, límite de solicitudes) y no se reserva nada. Los errores de trabajo terminan un trabajo ya aceptado como fallido, con un errorCode en el trabajo, y sus tokens reservados se liberan. Las tablas de abajo listan cada código con su solución.
Empieza ahora
Depura una solicitud fallida de Seedance
- 1
Lee el código, no el mensaje
Decide según code (errores de solicitud) o job.errorCode (errores de trabajo); los mensajes pueden cambiar, los códigos no.
- 2
Revisa primero los límites
La mayoría de los 400 son una duración, resolución o relación de aspecto que el modelo no ofrece. GET /v1/models lista los límites de cada modelo.
- 3
Respeta los 429
Espera los segundos de Retry-After antes de volver a enviar.
- 4
Reenvía con seguridad
Tras un timeout, reenvía con la misma Idempotency-Key. Tras un prompt rechazado, cámbialo y usa una clave nueva.
Errores de solicitud (falla la llamada HTTP)
| Código | Estado | Significado | Solución |
|---|---|---|---|
| invalid_api_key | 401 | La clave falta, es incorrecta o fue revocada. | Envía Authorization: Bearer <clave>. Crea una clave nueva si la revocaste. |
| insufficient_balance | 402 | No hay tokens suficientes para el costo cotizado. | Recarga en Billing. data.top_up_url enlaza ahí. |
| account_not_active | 403 | La cuenta de desarrollador está suspendida. | Contacta con soporte. |
| scope_missing | 403 | La clave no tiene el scope que necesita este endpoint. | Usa una clave con ese scope. |
| job_not_found | 404 | No hay ningún trabajo con ese id en la cuenta de esta clave. | Revisa el id; los trabajos son privados de cada cuenta. |
| character_not_found | 404 | El id o slug del personaje no existe. | Lista los personajes con GET /v1/characters. |
| upload_not_found | 404 | El upload_id no existe en este espacio de trabajo. | Vuelve a crear la subida. |
| reference_upload_not_found | 404 | Un upload_id de referencia no existe en este espacio de trabajo. | Vuelve a subir el archivo y usa el nuevo upload_id. |
| video_edit_source_not_found | 404 | El source_video_upload_id no existe. | Sube el clip con upload_type VIDEO. |
| upload_in_use | 409 | Un trabajo en cola o en proceso todavía usa esta subida. | Bórrala cuando termine el trabajo. |
| character_pending | 409 | El personaje todavía está en revisión. No se reservó nada. | Espera los segundos de retry_after y vuelve a intentarlo. |
| upload_too_large | 413 | El archivo supera el límite de tamaño para su tipo. | Imágenes 50 MB, video 200 MB, audio 15 MB. |
| character_registration_failed | 422 | La imagen del personaje no pasó la revisión. | Registra el personaje otra vez con otra imagen. |
| rate_limited | 429 | Demasiadas solicitudes en la ventana de tiempo. | Espera los segundos que indica el encabezado Retry-After. |
| prompt_required | 400 | No se envió ningún prompt (o texto, en el caso de voz). | Añade un prompt. |
| prompt_too_long | 400 | El prompt supera el límite del modelo. | Acórtalo; GET /v1/models indica maxPromptChars. |
| model_not_found | 400 | Alias de modelo desconocido. | Usa un id de GET /v1/models. |
| duration_not_supported | 400 | El modelo no ofrece esa duración. | Envía una de las duraciones del modelo. |
| aspect_ratio_not_supported | 400 | El modelo no ofrece esa relación de aspecto. | Envía una de las relaciones de aspecto del modelo. |
| resolution_not_supported | 400 | El modelo no ofrece esa resolución. | Envía una de las resoluciones del modelo. |
| reference_combination_not_supported | 400 | Estas referencias no se pueden combinar, por ejemplo fotogramas inicial y final con imágenes de referencia. | Envía un solo tipo por solicitud. |
| character_prompt_unsafe | 400 | El prompt de un personaje pide parecerse a una persona real. | Describe la apariencia, la ropa, la pose y el estilo. |
| person_match_prompt_unsafe | 400 | El prompt de una referencia pide imitar la cara o el parecido de una persona real. | Registra un personaje propio y describe el aspecto. |
| upload_invalid | 400 | A la solicitud de subida le falta un campo o tiene un tipo incorrecto. | Envía file_name, mime_type, file_size y upload_type. |
| video_edit_model_not_supported | 400 | La edición de video necesita un modelo de la familia Seedance 2.0 (2.0, Fast o Mini). | Usa kreator-video-pro, kreator-video-fast o kreator-video-mini. |
| video_edit_source_required | 400 | Una edición de video necesita un clip de origen. | Envía source_video_upload_id o video. |
| voice_required | 400 | La voz sintetizada necesita una voz. | Usa un id de GET /v1/voices. |
| internal_error | 500 | Algo falló de nuestro lado. | Vuelve a intentarlo con la misma Idempotency-Key. |
| dispatch_disabled | 503 | La generación está en pausa en este entorno. | Vuelve a intentarlo más tarde. |
Errores de trabajo (el trabajo termina como fallido y se liberan los tokens)
| Código | Significado | Solución |
|---|---|---|
| reference_rejected | Se rechazó una referencia (a menudo la foto de una persona real). | Registra la cara como personaje o usa otra imagen. |
| reference_asset_pending | Una referencia nueva todavía está en revisión. | Espera los segundos de errorData.retry_after y vuelve a enviarla con el mismo upload_id y una Idempotency-Key nueva. |
| reference_asset_failed | La referencia no pasó la revisión. | Usa otro archivo. |
| generation_rejected | Se rechazó la solicitud (prompt, referencia u opciones). | Cambia el prompt, la referencia o las opciones y vuelve a intentarlo. |
| generation_timeout | El trabajo no terminó a tiempo. Los tokens reservados se liberan. | Vuelve a intentarlo con una Idempotency-Key nueva. |
| generation_unavailable | El modelo no está disponible temporalmente. | Vuelve a intentarlo más tarde o elige otro modelo. |
| generation_failed | La generación falló. | Vuelve a intentarlo; si se repite, cambia el prompt o las referencias. |
¿Por qué se rechazó mi referencia?
Se rechazan las referencias y los prompts que piden parecerse a una persona real, una celebridad o una figura pública. Eso incluye fotos de personas reales usadas como referencia y prompts que nombran a una persona para imitarla. Describe la apariencia, la ropa y el estilo, o registra un personaje propio con POST /v1/characters y pasa su id.
¿Por qué el resultado tiene otra relación de aspecto?
Con una imagen de entrada o un primer fotograma, adaptive sigue la imagen. Envía un aspect_ratio explícito cuando el resultado deba ajustarse a un formato, y comprueba que el modelo lo ofrece.
¿Por qué falló camera_fixed con una imagen de entrada?
No envíes camera_fixed cuando mandes una imagen o un fotograma de entrada, y describe la cámara en el prompt (por ejemplo, locked-off camera).
Preguntas frecuentes
¿Se me cobra cuando falla un trabajo de Seedance?
No. Los tokens reservados de un trabajo fallido se liberan.
¿Qué significa insufficient_balance?
Tu saldo de tokens es menor que la cotización del trabajo. Recarga en la consola; no se reservó nada.
¿Qué hago con un 429?
Espera los segundos que indica el encabezado Retry-After y vuelve a enviar.
¿Por qué se rechazó mi prompt?
Pedía parecerse a una persona real o incumplía la política de uso aceptable. Cambia el prompt y crea un trabajo nuevo.
