API de vídeo de Seedance: modelos, campos y requisitos de recursos
Conecta Seedance con tu BetterToken API Key y elige los campos, recursos y métodos de generación según el Model ID y la operación.
Puedes generar vídeos a partir de texto, un fotograma inicial o recursos de referencia. Los cuatro modelos de la región de China admiten tres operaciones de generación; los dos SR admiten texto a vídeo e imagen a vídeo con un único fotograma inicial. Elige el Model ID según la operación, la duración y el nivel de salida que necesites.
Prepara tu BetterToken API Key. La Base URL es https://bettertoken.ai/v1 y la autenticación usa Authorization: Bearer YOUR_API_KEY. Copia el Model ID exactamente, respetando mayúsculas y minúsculas.
Cada request.json de esta página sigue el mismo proceso: solicita un presupuesto, confirma la creación, consulta el estado y descarga. El presupuesto no inicia la generación; la creación envía una tarea de pago. Consulta los precios actuales en el model plaza.
Modelos y operaciones
La tabla enumera las opciones de cada operación. Consulta los valores predeterminados, las cantidades de recursos y las restricciones de combinación en cada sección. Los tamaños usan 1 MB = 1048576 bytes.
| Model ID | Operación | Duración (segundos) | Nivel de salida | Relación de aspecto | Audio | Roles de recursos |
|---|---|---|---|---|---|---|
ByteDance-Seedance-2.0-SR | image_to_video | 5–10, incremento 5 | 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame |
ByteDance-Seedance-2.0-SR | text_to_video | 5–10, incremento 5 | 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Ninguno |
ByteDance-Seedance-2.5-SR | image_to_video | 5–10, incremento 5 | 720p, 1080p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame |
ByteDance-Seedance-2.5-SR | text_to_video | 5–10, incremento 5 | 720p, 1080p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Ninguno |
doubao-seedance-2-0-260128 | image_to_video | 4–15, incremento 1; admite auto | 480p, 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame, last_frame |
doubao-seedance-2-0-260128 | reference_to_video | 4–15, incremento 1; admite auto | 480p, 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | reference_image, reference_video, reference_audio |
doubao-seedance-2-0-260128 | text_to_video | 4–15, incremento 1; admite auto | 480p, 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Ninguno |
doubao-seedance-2-0-fast-260128 | image_to_video | 4–15, incremento 1; admite auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame, last_frame |
doubao-seedance-2-0-fast-260128 | reference_to_video | 4–15, incremento 1; admite auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | reference_image, reference_video, reference_audio |
doubao-seedance-2-0-fast-260128 | text_to_video | 4–15, incremento 1; admite auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Ninguno |
doubao-seedance-2-0-mini-260615 | image_to_video | 4–15, incremento 1; admite auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame, last_frame |
doubao-seedance-2-0-mini-260615 | reference_to_video | 4–15, incremento 1; admite auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | reference_image, reference_video, reference_audio |
doubao-seedance-2-0-mini-260615 | text_to_video | 4–15, incremento 1; admite auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Ninguno |
doubao-seedance-2-5-260628 | image_to_video | 4–30, incremento 1; admite auto | 480p, 720p, 1080p | adaptive | on, off | first_frame, last_frame |
doubao-seedance-2-5-260628 | reference_to_video | 4–30, incremento 1; admite auto | 480p, 720p, 1080p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | reference_image, reference_video, reference_audio |
doubao-seedance-2-5-260628 | text_to_video | 4–30, incremento 1; admite auto | 480p, 720p, 1080p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | Ninguno |
Los dos modelos SR solo admiten duraciones fijas de 5 o 10 segundos. Los modelos de la región de China y los SR tienen distintos Model ID; no apliques los campos ni los límites de recursos de un modelo a otro.
Recursos de ejemplo
Los ejemplos de generación desde imágenes y referencias usan una taza de cerámica azul sobre una mesa blanca. Puedes probar la imagen de ejemplo o sustituirla primero por recursos HTTPS públicos que tengas derecho a usar y que cumplan los límites de esta página.

De texto a vídeo
ByteDance-Seedance-2.0-SR
Usa esta operación para generar un vídeo cuando solo tienes una descripción de texto.
Establece model en el Model ID de esta sección y operation en text_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on, off | on |
duration.mode | string | No | fixed | fixed |
duration.seconds | integer | No | 5–10, incremento 5 s; solo con duración fija | 5 |
output.aspect_ratio | string | No | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | 16:9 |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 720p, 1080p, 4k | 720p |
prompt | string | Sí | Cadena | Ninguno |
watermark | boolean | No | false | false |
Requisitos de los recursos
Esta operación no acepta recursos.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "model": "ByteDance-Seedance-2.0-SR", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
ByteDance-Seedance-2.5-SR
Usa esta operación para generar un vídeo cuando solo tienes una descripción de texto.
Establece model en el Model ID de esta sección y operation en text_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on, off | on |
duration.mode | string | No | fixed | fixed |
duration.seconds | integer | No | 5–10, incremento 5 s; solo con duración fija | 5 |
output.aspect_ratio | string | No | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | 16:9 |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 720p, 1080p | 720p |
prompt | string | Sí | Cadena | Ninguno |
watermark | boolean | No | false | false |
Requisitos de los recursos
Esta operación no acepta recursos.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "model": "ByteDance-Seedance-2.5-SR", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
doubao-seedance-2-0-260128
Usa esta operación para generar un vídeo cuando solo tienes una descripción de texto.
Establece model en el Model ID de esta sección y operation en text_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on, off | on |
duration.mode | string | No | fixed, auto | fixed |
duration.seconds | integer | No | 4–15, incremento 1 s; solo con duración fija | Ninguno |
output.aspect_ratio | string | No | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 480p, 720p, 1080p, 4k | 720p |
prompt | string | Sí | Cadena | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
Esta operación no acepta recursos.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Con
duration.mode="auto", no envíesduration.seconds.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "model": "doubao-seedance-2-0-260128", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
excludes | Elimina los campos que entren en conflicto con la duración automática o el fotograma final. |
doubao-seedance-2-0-fast-260128
Usa esta operación para generar un vídeo cuando solo tienes una descripción de texto.
Establece model en el Model ID de esta sección y operation en text_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on, off | on |
duration.mode | string | No | fixed, auto | fixed |
duration.seconds | integer | No | 4–15, incremento 1 s; solo con duración fija | Ninguno |
output.aspect_ratio | string | No | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 480p, 720p | 720p |
prompt | string | Sí | Cadena | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
Esta operación no acepta recursos.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Con
duration.mode="auto", no envíesduration.seconds.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "model": "doubao-seedance-2-0-fast-260128", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
excludes | Elimina los campos que entren en conflicto con la duración automática o el fotograma final. |
doubao-seedance-2-0-mini-260615
Usa esta operación para generar un vídeo cuando solo tienes una descripción de texto.
Establece model en el Model ID de esta sección y operation en text_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on, off | on |
duration.mode | string | No | fixed, auto | fixed |
duration.seconds | integer | No | 4–15, incremento 1 s; solo con duración fija | Ninguno |
output.aspect_ratio | string | No | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 480p, 720p | 720p |
prompt | string | Sí | Cadena | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
Esta operación no acepta recursos.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Con
duration.mode="auto", no envíesduration.seconds.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "model": "doubao-seedance-2-0-mini-260615", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
excludes | Elimina los campos que entren en conflicto con la duración automática o el fotograma final. |
doubao-seedance-2-5-260628
Usa esta operación para generar un vídeo cuando solo tienes una descripción de texto.
Establece model en el Model ID de esta sección y operation en text_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on, off | on |
duration.mode | string | No | fixed, auto | auto |
duration.seconds | integer | No | 4–30, incremento 1 s; solo con duración fija | Ninguno |
output.aspect_ratio | string | No | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 480p, 720p, 1080p | 720p |
prompt | string | Sí | Cadena | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
Esta operación no acepta recursos.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Con
duration.mode="auto", no envíesduration.seconds.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "model": "doubao-seedance-2-5-260628", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "16:9" }}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
excludes | Elimina los campos que entren en conflicto con la duración automática o el fotograma final. |
De imagen a vídeo
ByteDance-Seedance-2.0-SR
Usa esta operación para fijar el primer fotograma o el primero y el último a partir de imágenes.
Establece model en el Model ID de esta sección y operation en image_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on, off | on |
duration.mode | string | No | fixed | fixed |
duration.seconds | integer | No | 5–10, incremento 5 s; solo con duración fija | 5 |
output.aspect_ratio | string | No | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | 16:9 |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 720p, 1080p, 4k | 720p |
prompt | string | Sí | Cadena | Ninguno |
watermark | boolean | No | false | false |
Requisitos de los recursos
| Rol del recurso | Tipo y cantidad | Formatos | Límites por archivo |
|---|---|---|---|
first_frame | image, 1 (obligatorio) | jpeg, png, webp | Tamaño máximo: 10 MB; ancho: 128–4096 px; alto: 128–4096 px |
Los requisitos de recursos también deben cumplir las restricciones de combinación siguientes.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Debes proporcionar
first_frame.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "model": "ByteDance-Seedance-2.0-SR", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
count / media_role | Ajusta los roles y las cantidades según la tabla de recursos de esta sección. |
video_input_unsupported | Comprueba la URL HTTPS pública, el Content-Type y el formato del archivo, y solicita otro presupuesto. |
ByteDance-Seedance-2.5-SR
Usa esta operación para fijar el primer fotograma o el primero y el último a partir de imágenes.
Establece model en el Model ID de esta sección y operation en image_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on, off | on |
duration.mode | string | No | fixed | fixed |
duration.seconds | integer | No | 5–10, incremento 5 s; solo con duración fija | 5 |
output.aspect_ratio | string | No | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | 16:9 |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 720p, 1080p | 720p |
prompt | string | Sí | Cadena | Ninguno |
watermark | boolean | No | false | false |
Requisitos de los recursos
| Rol del recurso | Tipo y cantidad | Formatos | Límites por archivo |
|---|---|---|---|
first_frame | image, 1 (obligatorio) | jpeg, png, webp | Tamaño máximo: 10 MB; ancho: 128–4096 px; alto: 128–4096 px |
Los requisitos de recursos también deben cumplir las restricciones de combinación siguientes.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Debes proporcionar
first_frame.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "model": "ByteDance-Seedance-2.5-SR", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
count / media_role | Ajusta los roles y las cantidades según la tabla de recursos de esta sección. |
video_input_unsupported | Comprueba la URL HTTPS pública, el Content-Type y el formato del archivo, y solicita otro presupuesto. |
doubao-seedance-2-0-260128
Usa esta operación para fijar el primer fotograma o el primero y el último a partir de imágenes.
Establece model en el Model ID de esta sección y operation en image_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on, off | on |
duration.mode | string | No | fixed, auto | fixed |
duration.seconds | integer | No | 4–15, incremento 1 s; solo con duración fija | Ninguno |
output.aspect_ratio | string | No | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 480p, 720p, 1080p, 4k | 720p |
prompt | string | Sí | Cadena | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
| Rol del recurso | Tipo y cantidad | Formatos | Límites por archivo |
|---|---|---|---|
first_frame | image, 1 (obligatorio) | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamaño: 1–31457279 bytes; ancho: 300–6000 px; alto: 300–6000 px |
last_frame | image, opcional, máximo 1 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamaño: 1–31457279 bytes; ancho: 300–6000 px; alto: 300–6000 px |
Los requisitos de recursos también deben cumplir las restricciones de combinación siguientes.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Con
duration.mode="auto", no envíesduration.seconds. - Debes proporcionar
first_frame.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "model": "doubao-seedance-2-0-260128", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
excludes | Elimina los campos que entren en conflicto con la duración automática o el fotograma final. |
count / media_role | Ajusta los roles y las cantidades según la tabla de recursos de esta sección. |
video_input_unsupported | Comprueba la URL HTTPS pública, el Content-Type y el formato del archivo, y solicita otro presupuesto. |
doubao-seedance-2-0-fast-260128
Usa esta operación para fijar el primer fotograma o el primero y el último a partir de imágenes.
Establece model en el Model ID de esta sección y operation en image_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on, off | on |
duration.mode | string | No | fixed, auto | fixed |
duration.seconds | integer | No | 4–15, incremento 1 s; solo con duración fija | Ninguno |
output.aspect_ratio | string | No | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 480p, 720p | 720p |
prompt | string | Sí | Cadena | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
| Rol del recurso | Tipo y cantidad | Formatos | Límites por archivo |
|---|---|---|---|
first_frame | image, 1 (obligatorio) | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamaño: 1–31457279 bytes; ancho: 300–6000 px; alto: 300–6000 px |
last_frame | image, opcional, máximo 1 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamaño: 1–31457279 bytes; ancho: 300–6000 px; alto: 300–6000 px |
Los requisitos de recursos también deben cumplir las restricciones de combinación siguientes.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Con
duration.mode="auto", no envíesduration.seconds. - Debes proporcionar
first_frame.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "model": "doubao-seedance-2-0-fast-260128", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
excludes | Elimina los campos que entren en conflicto con la duración automática o el fotograma final. |
count / media_role | Ajusta los roles y las cantidades según la tabla de recursos de esta sección. |
video_input_unsupported | Comprueba la URL HTTPS pública, el Content-Type y el formato del archivo, y solicita otro presupuesto. |
doubao-seedance-2-0-mini-260615
Usa esta operación para fijar el primer fotograma o el primero y el último a partir de imágenes.
Establece model en el Model ID de esta sección y operation en image_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on, off | on |
duration.mode | string | No | fixed, auto | fixed |
duration.seconds | integer | No | 4–15, incremento 1 s; solo con duración fija | Ninguno |
output.aspect_ratio | string | No | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 480p, 720p | 720p |
prompt | string | Sí | Cadena | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
| Rol del recurso | Tipo y cantidad | Formatos | Límites por archivo |
|---|---|---|---|
first_frame | image, 1 (obligatorio) | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamaño: 1–31457279 bytes; ancho: 300–6000 px; alto: 300–6000 px |
last_frame | image, opcional, máximo 1 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamaño: 1–31457279 bytes; ancho: 300–6000 px; alto: 300–6000 px |
Los requisitos de recursos también deben cumplir las restricciones de combinación siguientes.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Con
duration.mode="auto", no envíesduration.seconds. - Debes proporcionar
first_frame.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "model": "doubao-seedance-2-0-mini-260615", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
excludes | Elimina los campos que entren en conflicto con la duración automática o el fotograma final. |
count / media_role | Ajusta los roles y las cantidades según la tabla de recursos de esta sección. |
video_input_unsupported | Comprueba la URL HTTPS pública, el Content-Type y el formato del archivo, y solicita otro presupuesto. |
doubao-seedance-2-5-260628
Usa esta operación para fijar el primer fotograma o el primero y el último a partir de imágenes.
Establece model en el Model ID de esta sección y operation en image_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on, off | on |
duration.mode | string | No | fixed, auto | auto |
duration.seconds | integer | No | 4–30, incremento 1 s; solo con duración fija | Ninguno |
output.aspect_ratio | string | No | adaptive | adaptive |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 480p, 720p, 1080p | 720p |
prompt | string | Sí | Cadena | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
| Rol del recurso | Tipo y cantidad | Formatos | Límites por archivo |
|---|---|---|---|
first_frame | image, 1 (obligatorio) | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamaño: 1–31457279 bytes; ancho: 300–6000 px; alto: 300–6000 px |
last_frame | image, opcional, máximo 1 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamaño: 1–31457279 bytes; ancho: 300–6000 px; alto: 300–6000 px |
Los requisitos de recursos también deben cumplir las restricciones de combinación siguientes.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Con
duration.mode="auto", no envíesduration.seconds. - Debes proporcionar
first_frame. - Esta operación requiere
output.aspect_ratio="adaptive", tanto con un único fotograma inicial como con fotogramas inicial y final.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "model": "doubao-seedance-2-5-260628", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
excludes | Elimina los campos que entren en conflicto con la duración automática o el fotograma final. |
count / media_role | Ajusta los roles y las cantidades según la tabla de recursos de esta sección. |
video_input_unsupported | Comprueba la URL HTTPS pública, el Content-Type y el formato del archivo, y solicita otro presupuesto. |
Generación con referencias
doubao-seedance-2-0-260128
Usa esta operación para conservar las características del sujeto o del movimiento mediante recursos de referencia.
Establece model en el Model ID de esta sección y operation en reference_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on, off | on |
duration.mode | string | No | fixed, auto | fixed |
duration.seconds | integer | No | 4–15, incremento 1 s; solo con duración fija | Ninguno |
output.aspect_ratio | string | No | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 480p, 720p, 1080p, 4k | 720p |
prompt | string | Sí | Cadena | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
| Rol del recurso | Tipo y cantidad | Formatos | Límites por archivo |
|---|---|---|---|
reference_image | image, opcional, máximo 9 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamaño: 1–31457279 bytes; ancho: 300–6000 px; alto: 300–6000 px |
reference_video | video, opcional, máximo 3 | mp4, mov | Tamaño máximo: 200 MB; ancho: 300–6000 px; alto: 300–6000 px; duración: 2–15 s; velocidad de fotogramas mínima: 24 fps; máxima: 60 fps; duración total máxima de este rol: 15 s |
reference_audio | audio, opcional, máximo 3 | wav, mp3 | Tamaño máximo: 15 MB; duración: 2–15 s; duración total máxima de este rol: 15 s |
Los requisitos de recursos también deben cumplir las restricciones de combinación siguientes.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Con
duration.mode="auto", no envíesduration.seconds. - Proporciona al menos uno de estos roles:
reference_image,reference_video,reference_audio. - El audio de referencia no se puede usar solo; incluye también imágenes o vídeos de referencia.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "model": "doubao-seedance-2-0-260128", "operation": "reference_to_video", "prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "reference", "type": "image", "role": "reference_image", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
excludes | Elimina los campos que entren en conflicto con la duración automática o el fotograma final. |
count / media_role | Ajusta los roles y las cantidades según la tabla de recursos de esta sección. |
video_input_unsupported | Comprueba la URL HTTPS pública, el Content-Type y el formato del archivo, y solicita otro presupuesto. |
doubao-seedance-2-0-fast-260128
Usa esta operación para conservar las características del sujeto o del movimiento mediante recursos de referencia.
Establece model en el Model ID de esta sección y operation en reference_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on, off | on |
duration.mode | string | No | fixed, auto | fixed |
duration.seconds | integer | No | 4–15, incremento 1 s; solo con duración fija | Ninguno |
output.aspect_ratio | string | No | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 480p, 720p | 720p |
prompt | string | Sí | Cadena | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
| Rol del recurso | Tipo y cantidad | Formatos | Límites por archivo |
|---|---|---|---|
reference_image | image, opcional, máximo 9 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamaño: 1–31457279 bytes; ancho: 300–6000 px; alto: 300–6000 px |
reference_video | video, opcional, máximo 3 | mp4, mov | Tamaño máximo: 200 MB; ancho: 300–6000 px; alto: 300–6000 px; duración: 2–15 s; velocidad de fotogramas mínima: 24 fps; máxima: 60 fps; duración total máxima de este rol: 15 s |
reference_audio | audio, opcional, máximo 3 | wav, mp3 | Tamaño máximo: 15 MB; duración: 2–15 s; duración total máxima de este rol: 15 s |
Los requisitos de recursos también deben cumplir las restricciones de combinación siguientes.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Con
duration.mode="auto", no envíesduration.seconds. - Proporciona al menos uno de estos roles:
reference_image,reference_video,reference_audio. - El audio de referencia no se puede usar solo; incluye también imágenes o vídeos de referencia.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "model": "doubao-seedance-2-0-fast-260128", "operation": "reference_to_video", "prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "reference", "type": "image", "role": "reference_image", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
excludes | Elimina los campos que entren en conflicto con la duración automática o el fotograma final. |
count / media_role | Ajusta los roles y las cantidades según la tabla de recursos de esta sección. |
video_input_unsupported | Comprueba la URL HTTPS pública, el Content-Type y el formato del archivo, y solicita otro presupuesto. |
doubao-seedance-2-0-mini-260615
Usa esta operación para conservar las características del sujeto o del movimiento mediante recursos de referencia.
Establece model en el Model ID de esta sección y operation en reference_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on, off | on |
duration.mode | string | No | fixed, auto | fixed |
duration.seconds | integer | No | 4–15, incremento 1 s; solo con duración fija | Ninguno |
output.aspect_ratio | string | No | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 480p, 720p | 720p |
prompt | string | Sí | Cadena | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
| Rol del recurso | Tipo y cantidad | Formatos | Límites por archivo |
|---|---|---|---|
reference_image | image, opcional, máximo 9 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamaño: 1–31457279 bytes; ancho: 300–6000 px; alto: 300–6000 px |
reference_video | video, opcional, máximo 3 | mp4, mov | Tamaño máximo: 200 MB; ancho: 300–6000 px; alto: 300–6000 px; duración: 2–15 s; velocidad de fotogramas mínima: 24 fps; máxima: 60 fps; duración total máxima de este rol: 15 s |
reference_audio | audio, opcional, máximo 3 | wav, mp3 | Tamaño máximo: 15 MB; duración: 2–15 s; duración total máxima de este rol: 15 s |
Los requisitos de recursos también deben cumplir las restricciones de combinación siguientes.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Con
duration.mode="auto", no envíesduration.seconds. - Proporciona al menos uno de estos roles:
reference_image,reference_video,reference_audio. - El audio de referencia no se puede usar solo; incluye también imágenes o vídeos de referencia.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "model": "doubao-seedance-2-0-mini-260615", "operation": "reference_to_video", "prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "reference", "type": "image", "role": "reference_image", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
excludes | Elimina los campos que entren en conflicto con la duración automática o el fotograma final. |
count / media_role | Ajusta los roles y las cantidades según la tabla de recursos de esta sección. |
video_input_unsupported | Comprueba la URL HTTPS pública, el Content-Type y el formato del archivo, y solicita otro presupuesto. |
doubao-seedance-2-5-260628
Usa esta operación para conservar las características del sujeto o del movimiento mediante recursos de referencia.
Establece model en el Model ID de esta sección y operation en reference_to_video. Usa solo los campos de generación de la tabla siguiente; coloca los recursos en el array media.
| Campo | Tipo | Obligatorio | Opciones o rango | Valor predeterminado |
|---|---|---|---|---|
audio.mode | string | No | on, off | on |
duration.mode | string | No | fixed, auto | auto |
duration.seconds | integer | No | 4–30, incremento 1 s; solo con duración fija | Ninguno |
output.aspect_ratio | string | No | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | No | mp4 | mp4 |
output.resolution | string | No | 480p, 720p, 1080p | 720p |
prompt | string | Sí | Cadena | Ninguno |
watermark | boolean | No | false, true | false |
Requisitos de los recursos
| Rol del recurso | Tipo y cantidad | Formatos | Límites por archivo |
|---|---|---|---|
reference_image | image, opcional, máximo 30 | jpeg, png, webp, bmp, tiff, gif, heic, heif | Tamaño: 1–31457279 bytes; ancho: 300–6000 px; alto: 300–6000 px |
reference_video | video, opcional, máximo 10 | mp4, mov | Tamaño máximo: 200 MB; ancho: 300–6000 px; alto: 300–6000 px; duración: 2–30 s; velocidad de fotogramas mínima: 24 fps; máxima: 60 fps; duración total máxima de este rol: 30 s |
reference_audio | audio, opcional, máximo 10 | wav, mp3 | Tamaño máximo: 15 MB; duración: 2–30 s; duración total máxima de este rol: 30 s |
Los requisitos de recursos también deben cumplir las restricciones de combinación siguientes.
Restricciones de combinación
duration.mode="fixed"requiereduration.seconds. Cuando indiquesfixedexplícitamente, incluye también los segundos.- Con
duration.mode="auto", no envíesduration.seconds. - Proporciona al menos uno de estos roles:
reference_image,reference_video,reference_audio.
Ejemplo de solicitud
Guarda el JSON siguiente como request.json y sigue el proceso general: solicita un presupuesto y confirma antes de crear la tarea.
{ "model": "doubao-seedance-2-5-260628", "operation": "reference_to_video", "prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "720p", "aspect_ratio": "adaptive" }, "media": [ { "id": "reference", "type": "image", "role": "reference_image", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}Errores 422 frecuentes
| Código de error 422 | Solución |
|---|---|
enum / range / step | Ajusta los valores y el incremento según la tabla de campos de esta sección. |
unsupported_field | Elimina los campos que no figuran en la tabla de esta operación. |
requires | Completa los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección. |
excludes | Elimina los campos que entren en conflicto con la duración automática o el fotograma final. |
count / media_role | Ajusta los roles y las cantidades según la tabla de recursos de esta sección. |
video_input_unsupported | Comprueba la URL HTTPS pública, el Content-Type y el formato del archivo, y solicita otro presupuesto. |
Documentación oficial
Al llamar a BetterToken, usa los campos de esta página y la operación correspondiente del catálogo de modelos en tiempo real.

