Ir al contenido
Regístrate gratis
Seedance

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 IDOperaciónDuración (segundos)Nivel de salidaRelación de aspectoAudioRoles de recursos
ByteDance-Seedance-2.0-SRimage_to_video5–10, incremento 5720p, 1080p, 4k16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offfirst_frame
ByteDance-Seedance-2.0-SRtext_to_video5–10, incremento 5720p, 1080p, 4k16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offNinguno
ByteDance-Seedance-2.5-SRimage_to_video5–10, incremento 5720p, 1080p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offfirst_frame
ByteDance-Seedance-2.5-SRtext_to_video5–10, incremento 5720p, 1080p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offNinguno
doubao-seedance-2-0-260128image_to_video4–15, incremento 1; admite auto480p, 720p, 1080p, 4k16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offfirst_frame, last_frame
doubao-seedance-2-0-260128reference_to_video4–15, incremento 1; admite auto480p, 720p, 1080p, 4k16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offreference_image, reference_video, reference_audio
doubao-seedance-2-0-260128text_to_video4–15, incremento 1; admite auto480p, 720p, 1080p, 4k16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offNinguno
doubao-seedance-2-0-fast-260128image_to_video4–15, incremento 1; admite auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offfirst_frame, last_frame
doubao-seedance-2-0-fast-260128reference_to_video4–15, incremento 1; admite auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offreference_image, reference_video, reference_audio
doubao-seedance-2-0-fast-260128text_to_video4–15, incremento 1; admite auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offNinguno
doubao-seedance-2-0-mini-260615image_to_video4–15, incremento 1; admite auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offfirst_frame, last_frame
doubao-seedance-2-0-mini-260615reference_to_video4–15, incremento 1; admite auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offreference_image, reference_video, reference_audio
doubao-seedance-2-0-mini-260615text_to_video4–15, incremento 1; admite auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offNinguno
doubao-seedance-2-5-260628image_to_video4–30, incremento 1; admite auto480p, 720p, 1080padaptiveon, offfirst_frame, last_frame
doubao-seedance-2-5-260628reference_to_video4–30, incremento 1; admite auto480p, 720p, 1080p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offreference_image, reference_video, reference_audio
doubao-seedance-2-5-260628text_to_video4–30, incremento 1; admite auto480p, 720p, 1080p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offNinguno

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.

Imagen de referencia para generar vídeo: taza de cerámica azul sobre una mesa blanca

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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoon, offon
duration.modestringNofixedfixed
duration.secondsintegerNo5–10, incremento 5 s; solo con duración fija5
output.aspect_ratiostringNo16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive16:9
output.formatstringNomp4mp4
output.resolutionstringNo720p, 1080p, 4k720p
promptstringSíCadenaNinguno
watermarkbooleanNofalsefalse

Requisitos de los recursos

Esta operación no acepta recursos.

Restricciones de combinación

  • duration.mode="fixed" requiere duration.seconds. Cuando indiques fixed explí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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoon, offon
duration.modestringNofixedfixed
duration.secondsintegerNo5–10, incremento 5 s; solo con duración fija5
output.aspect_ratiostringNo16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive16:9
output.formatstringNomp4mp4
output.resolutionstringNo720p, 1080p720p
promptstringSíCadenaNinguno
watermarkbooleanNofalsefalse

Requisitos de los recursos

Esta operación no acepta recursos.

Restricciones de combinación

  • duration.mode="fixed" requiere duration.seconds. Cuando indiques fixed explí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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoon, offon
duration.modestringNofixed, autofixed
duration.secondsintegerNo4–15, incremento 1 s; solo con duración fijaNinguno
output.aspect_ratiostringNo16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringNomp4mp4
output.resolutionstringNo480p, 720p, 1080p, 4k720p
promptstringSíCadenaNinguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Esta operación no acepta recursos.

Restricciones de combinación

  • duration.mode="fixed" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.
  • Con duration.mode="auto", no envíes duration.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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
excludesElimina 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoon, offon
duration.modestringNofixed, autofixed
duration.secondsintegerNo4–15, incremento 1 s; solo con duración fijaNinguno
output.aspect_ratiostringNo16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringNomp4mp4
output.resolutionstringNo480p, 720p720p
promptstringSíCadenaNinguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Esta operación no acepta recursos.

Restricciones de combinación

  • duration.mode="fixed" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.
  • Con duration.mode="auto", no envíes duration.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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
excludesElimina 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoon, offon
duration.modestringNofixed, autofixed
duration.secondsintegerNo4–15, incremento 1 s; solo con duración fijaNinguno
output.aspect_ratiostringNo16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringNomp4mp4
output.resolutionstringNo480p, 720p720p
promptstringSíCadenaNinguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Esta operación no acepta recursos.

Restricciones de combinación

  • duration.mode="fixed" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.
  • Con duration.mode="auto", no envíes duration.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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
excludesElimina 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoon, offon
duration.modestringNofixed, autoauto
duration.secondsintegerNo4–30, incremento 1 s; solo con duración fijaNinguno
output.aspect_ratiostringNo16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringNomp4mp4
output.resolutionstringNo480p, 720p, 1080p720p
promptstringSíCadenaNinguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Esta operación no acepta recursos.

Restricciones de combinación

  • duration.mode="fixed" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.
  • Con duration.mode="auto", no envíes duration.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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
excludesElimina 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoon, offon
duration.modestringNofixedfixed
duration.secondsintegerNo5–10, incremento 5 s; solo con duración fija5
output.aspect_ratiostringNo16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive16:9
output.formatstringNomp4mp4
output.resolutionstringNo720p, 1080p, 4k720p
promptstringSíCadenaNinguno
watermarkbooleanNofalsefalse

Requisitos de los recursos

Rol del recursoTipo y cantidadFormatosLímites por archivo
first_frameimage, 1 (obligatorio)jpeg, png, webpTamañ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" requiere duration.seconds. Cuando indiques fixed explí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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
count / media_roleAjusta los roles y las cantidades según la tabla de recursos de esta sección.
video_input_unsupportedComprueba 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoon, offon
duration.modestringNofixedfixed
duration.secondsintegerNo5–10, incremento 5 s; solo con duración fija5
output.aspect_ratiostringNo16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive16:9
output.formatstringNomp4mp4
output.resolutionstringNo720p, 1080p720p
promptstringSíCadenaNinguno
watermarkbooleanNofalsefalse

Requisitos de los recursos

Rol del recursoTipo y cantidadFormatosLímites por archivo
first_frameimage, 1 (obligatorio)jpeg, png, webpTamañ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" requiere duration.seconds. Cuando indiques fixed explí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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
count / media_roleAjusta los roles y las cantidades según la tabla de recursos de esta sección.
video_input_unsupportedComprueba 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoon, offon
duration.modestringNofixed, autofixed
duration.secondsintegerNo4–15, incremento 1 s; solo con duración fijaNinguno
output.aspect_ratiostringNo16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringNomp4mp4
output.resolutionstringNo480p, 720p, 1080p, 4k720p
promptstringSíCadenaNinguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Rol del recursoTipo y cantidadFormatosLímites por archivo
first_frameimage, 1 (obligatorio)jpeg, png, webp, bmp, tiff, gif, heic, heifTamaño: 1–31457279 bytes; ancho: 300–6000 px; alto: 300–6000 px
last_frameimage, opcional, máximo 1jpeg, png, webp, bmp, tiff, gif, heic, heifTamañ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" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.
  • Con duration.mode="auto", no envíes duration.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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
excludesElimina los campos que entren en conflicto con la duración automática o el fotograma final.
count / media_roleAjusta los roles y las cantidades según la tabla de recursos de esta sección.
video_input_unsupportedComprueba 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoon, offon
duration.modestringNofixed, autofixed
duration.secondsintegerNo4–15, incremento 1 s; solo con duración fijaNinguno
output.aspect_ratiostringNo16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringNomp4mp4
output.resolutionstringNo480p, 720p720p
promptstringSíCadenaNinguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Rol del recursoTipo y cantidadFormatosLímites por archivo
first_frameimage, 1 (obligatorio)jpeg, png, webp, bmp, tiff, gif, heic, heifTamaño: 1–31457279 bytes; ancho: 300–6000 px; alto: 300–6000 px
last_frameimage, opcional, máximo 1jpeg, png, webp, bmp, tiff, gif, heic, heifTamañ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" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.
  • Con duration.mode="auto", no envíes duration.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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
excludesElimina los campos que entren en conflicto con la duración automática o el fotograma final.
count / media_roleAjusta los roles y las cantidades según la tabla de recursos de esta sección.
video_input_unsupportedComprueba 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoon, offon
duration.modestringNofixed, autofixed
duration.secondsintegerNo4–15, incremento 1 s; solo con duración fijaNinguno
output.aspect_ratiostringNo16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringNomp4mp4
output.resolutionstringNo480p, 720p720p
promptstringSíCadenaNinguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Rol del recursoTipo y cantidadFormatosLímites por archivo
first_frameimage, 1 (obligatorio)jpeg, png, webp, bmp, tiff, gif, heic, heifTamaño: 1–31457279 bytes; ancho: 300–6000 px; alto: 300–6000 px
last_frameimage, opcional, máximo 1jpeg, png, webp, bmp, tiff, gif, heic, heifTamañ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" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.
  • Con duration.mode="auto", no envíes duration.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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
excludesElimina los campos que entren en conflicto con la duración automática o el fotograma final.
count / media_roleAjusta los roles y las cantidades según la tabla de recursos de esta sección.
video_input_unsupportedComprueba 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoon, offon
duration.modestringNofixed, autoauto
duration.secondsintegerNo4–30, incremento 1 s; solo con duración fijaNinguno
output.aspect_ratiostringNoadaptiveadaptive
output.formatstringNomp4mp4
output.resolutionstringNo480p, 720p, 1080p720p
promptstringSíCadenaNinguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Rol del recursoTipo y cantidadFormatosLímites por archivo
first_frameimage, 1 (obligatorio)jpeg, png, webp, bmp, tiff, gif, heic, heifTamaño: 1–31457279 bytes; ancho: 300–6000 px; alto: 300–6000 px
last_frameimage, opcional, máximo 1jpeg, png, webp, bmp, tiff, gif, heic, heifTamañ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" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.
  • Con duration.mode="auto", no envíes duration.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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
excludesElimina los campos que entren en conflicto con la duración automática o el fotograma final.
count / media_roleAjusta los roles y las cantidades según la tabla de recursos de esta sección.
video_input_unsupportedComprueba 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoon, offon
duration.modestringNofixed, autofixed
duration.secondsintegerNo4–15, incremento 1 s; solo con duración fijaNinguno
output.aspect_ratiostringNo16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringNomp4mp4
output.resolutionstringNo480p, 720p, 1080p, 4k720p
promptstringSíCadenaNinguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Rol del recursoTipo y cantidadFormatosLímites por archivo
reference_imageimage, opcional, máximo 9jpeg, png, webp, bmp, tiff, gif, heic, heifTamaño: 1–31457279 bytes; ancho: 300–6000 px; alto: 300–6000 px
reference_videovideo, opcional, máximo 3mp4, movTamañ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_audioaudio, opcional, máximo 3wav, mp3Tamañ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" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.
  • Con duration.mode="auto", no envíes duration.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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
excludesElimina los campos que entren en conflicto con la duración automática o el fotograma final.
count / media_roleAjusta los roles y las cantidades según la tabla de recursos de esta sección.
video_input_unsupportedComprueba 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoon, offon
duration.modestringNofixed, autofixed
duration.secondsintegerNo4–15, incremento 1 s; solo con duración fijaNinguno
output.aspect_ratiostringNo16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringNomp4mp4
output.resolutionstringNo480p, 720p720p
promptstringSíCadenaNinguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Rol del recursoTipo y cantidadFormatosLímites por archivo
reference_imageimage, opcional, máximo 9jpeg, png, webp, bmp, tiff, gif, heic, heifTamaño: 1–31457279 bytes; ancho: 300–6000 px; alto: 300–6000 px
reference_videovideo, opcional, máximo 3mp4, movTamañ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_audioaudio, opcional, máximo 3wav, mp3Tamañ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" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.
  • Con duration.mode="auto", no envíes duration.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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
excludesElimina los campos que entren en conflicto con la duración automática o el fotograma final.
count / media_roleAjusta los roles y las cantidades según la tabla de recursos de esta sección.
video_input_unsupportedComprueba 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoon, offon
duration.modestringNofixed, autofixed
duration.secondsintegerNo4–15, incremento 1 s; solo con duración fijaNinguno
output.aspect_ratiostringNo16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringNomp4mp4
output.resolutionstringNo480p, 720p720p
promptstringSíCadenaNinguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Rol del recursoTipo y cantidadFormatosLímites por archivo
reference_imageimage, opcional, máximo 9jpeg, png, webp, bmp, tiff, gif, heic, heifTamaño: 1–31457279 bytes; ancho: 300–6000 px; alto: 300–6000 px
reference_videovideo, opcional, máximo 3mp4, movTamañ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_audioaudio, opcional, máximo 3wav, mp3Tamañ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" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.
  • Con duration.mode="auto", no envíes duration.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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
excludesElimina los campos que entren en conflicto con la duración automática o el fotograma final.
count / media_roleAjusta los roles y las cantidades según la tabla de recursos de esta sección.
video_input_unsupportedComprueba 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.

CampoTipoObligatorioOpciones o rangoValor predeterminado
audio.modestringNoon, offon
duration.modestringNofixed, autoauto
duration.secondsintegerNo4–30, incremento 1 s; solo con duración fijaNinguno
output.aspect_ratiostringNo16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringNomp4mp4
output.resolutionstringNo480p, 720p, 1080p720p
promptstringSíCadenaNinguno
watermarkbooleanNofalse, truefalse

Requisitos de los recursos

Rol del recursoTipo y cantidadFormatosLímites por archivo
reference_imageimage, opcional, máximo 30jpeg, png, webp, bmp, tiff, gif, heic, heifTamaño: 1–31457279 bytes; ancho: 300–6000 px; alto: 300–6000 px
reference_videovideo, opcional, máximo 10mp4, movTamañ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_audioaudio, opcional, máximo 10wav, mp3Tamañ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" requiere duration.seconds. Cuando indiques fixed explícitamente, incluye también los segundos.
  • Con duration.mode="auto", no envíes duration.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 422Solución
enum / range / stepAjusta los valores y el incremento según la tabla de campos de esta sección.
unsupported_fieldElimina los campos que no figuran en la tabla de esta operación.
requiresCompleta los segundos, la relación de aspecto, el audio o los recursos según las restricciones de esta sección.
excludesElimina los campos que entren en conflicto con la duración automática o el fotograma final.
count / media_roleAjusta los roles y las cantidades según la tabla de recursos de esta sección.
video_input_unsupportedComprueba 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.