{ "aboutHtml": "

Seedance 2.0 Fast es la edición de ByteDance Seed centrada en velocidad de la familia Seedance 2.0. Admite generación conjunta de video y audio y un encargo multimodal formado por texto, imágenes, video y sonido. Sus capacidades creativas incluyen escenas nuevas guiadas por referencias, edición de material existente y extensión de una escena; sus niveles de salida documentados son 480p y 720p.

Referencia multimodal: asignar funciones al material

Una imagen puede aportar personaje, producto, composición o tratamiento visual. Un video de referencia puede aportar acción, movimiento de cámara o un efecto. El audio puede aportar timbre de voz, melodía musical o contenido del diálogo. Explica qué parte de cada fuente quieres trasladar a la escena nueva; una referencia resulta más útil con una función creativa concreta.

Por ejemplo: «Usa la lámpara de cerámica de Image 1 como producto. Sigue la órbita lenta de cámara de Video 1, pero sitúa la lámpara en un rincón tranquilo de lectura. Usa Audio 1 para el ambiente musical». La salida prevista es una escena nueva que combine apariencia, movimiento y dirección sonora elegidos, en lugar de una imitación indefinida de todos los detalles de las referencias.

Las combinaciones documentadas incluyen imágenes con audio, imágenes con video, video con audio y los tres juntos. No se admiten texto con audio solo ni entrada únicamente de audio. El modelo también admite texto a video y generación basada en imagen con primer fotograma o pareja de primero y último. Cuando un punto final exacto sea central, usa su flujo específico; describir una imagen de referencia como extremo en omni-reference es control indirecto.

Edición de un video existente

El modelo puede añadir, eliminar o modificar elementos, sustituir un sujeto y redibujar o reparar partes de una escena. Identifica el video fuente, el objeto a cambiar y los elementos que deben permanecer. Para una adición, describe dónde y cuándo aparece. Para eliminar, identifica el objeto de forma consistente en todo el clip.

Un encargo práctico podría sustituir una botella lisa de una demostración por la de Image 1, conservando movimiento de mano, fondo y trayectoria de cámara de Video 1. Revisa tanto la sustitución como las zonas que deben quedar estables. Las instrucciones claras de conservación facilitan evaluar la edición más que pedir de forma general «mejorar» el material.

Extensión y conexión de clips

Seedance 2.0 Fast admite extensión hacia adelante o atrás y conexión de dos o tres clips mediante transiciones generadas. Para extender, indica si la nueva acción sucede antes o después del video y descríbela. Para conectar, aporta los clips en el orden previsto y explica el evento visual que los une.

Una extensión sencilla suele devolver la continuación nueva alrededor del material original, sin suponer que se repita todo el clip fuente. Si la salida debe contener el segmento original, dilo. Al completar una transición entre dos o tres videos, el flujo documentado puede combinar contenido original y generado. Esto sirve para unir una vista amplia de producto con un detalle mediante un movimiento de cámara deliberado.

Salida y diferencias entre ediciones

La salida documentada de Fast es MP4 a 24 fps, 480p o 720p, profundidad de color de 8 bits y clips de 4–15 segundos. Las relaciones compatibles son 21:9, 16:9, 4:3, 1:1, 3:4 y 9:16. La edición estándar Seedance 2.0 enumera por separado 1080p y 4K; esos niveles no son parte de Fast. La familia 2.0 permite devolver el último fotograma generado, pero no admite el modo independiente de vista previa Draft.

Puede generarse audio con el material u omitirse para un clip silencioso. El audio generado es mono. Los idiomas documentados de instrucciones incluyen inglés, español, indonesio, portugués y japonés. Mantén consistente el idioma hablado en un diálogo; la guía desaconseja mezclar idiomas salvo nombres propios. Para una escena hablada, nombra al hablante y pon la línea entre comillas; después especifica interpretación y efectos pertinentes. Ajusta la interpretación requerida a la duración elegida.

Preparación de referencias y límites de entrada

Los límites documentados son hasta nueve imágenes, tres videos y tres clips de audio. Este perfil del fabricante no acepta cargas directas de imagen o video de referencia con rostros humanos reales; los retratos usan su flujo compatible de recursos de retrato. Cada clip de video o audio debe durar 2–15 segundos; el video combinado tiene un máximo de 15 segundos y el audio combinado otro máximo independiente de 15 segundos. Los videos usan MP4 o MOV a 24–60 fps y no deben superar 200 MB cada uno. Los audios usan WAV o MP3 y no deben superar 15 MB cada uno. Los formatos de imagen enumerados son JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC y HEIF. Cada imagen debe pesar menos de 30 MB; el cuerpo total de solicitud tiene un límite de 64 MB. En el perfil documentado, ancho y alto de imagen deben estar estrictamente entre 300 y 6,000 píxeles, con relación ancho/alto estrictamente entre 0.4 y 2.5. Los videos permiten 300–6,000 píxeles por dimensión y relaciones de 0.4–2.5, inclusive, con 407,696–8,295,044 píxeles totales. Los videos MP4 o MOV usan H.264/AVC o H.265/HEVC y audio AAC o MP3.

Ordena los recursos y menciónalos consistentemente como Image 1, Video 1 o Audio 1. Usa también el nombre o rasgo distintivo del sujeto visible junto con el número. Ajusta el encuadre de imágenes límite a la relación de aspecto prevista, porque una discrepancia puede recortar la imagen o provocar un cambio brusco. Centra el encargo en los rasgos a transferir, el evento a generar y lo que conservar; una instrucción larga puede dispersar las indicaciones y dejar sin resolver detalles secundarios.

Plan de tomas, texto y comportamientos conocidos

Organiza un encargo complejo como Toma 1, Toma 2 y Toma 3, con sujeto, acción, posición y sonido claros para cada una. La guía recomienda un movimiento de cámara por toma y advierte que las marcas de tiempo exactas por toma son inestables. Da a cada personaje una etiqueta estable y algunos rasgos distintivos; cuando importe la identidad facial, usa un retrato claro y una referencia de cuerpo completo separados en vez de una hoja combinada de vistas del personaje.

El modelo puede generar texto común, incluidos lemas, subtítulos y globos de diálogo, con indicaciones de color, estilo, posición y entrada. Se prefieren caracteres comunes a caracteres raros o símbolos especiales. Revisa las letras en movimiento. Los subtítulos, logotipos y personajes duplicados no deseados son comportamientos documentados; las restricciones explícitas y referencias limpias pueden reducirlos, sin garantizar su ausencia. Más de cuatro personas de referencia se considera un riesgo de estabilidad, no un límite estricto de cantidad de archivos.

Las extensiones repetidas pueden acumular pérdida de calidad de imagen y una unión puede saltar o retroceder. Limita las continuaciones encadenadas y revisa la unión al editar. El timbre de voz de referencia puede variar, la narración puede terminar con un clic y los caracteres chinos polifónicos o poco comunes pueden pronunciarse mal. Revisa la línea hablada y el audio final; un fundido breve de audio puede ayudar con un corte. Estas comprobaciones forman parte de preparar el resultado creativo, especialmente cuando el habla o la continuidad de personajes sostienen la historia.

", "aboutText": "Seedance 2.0 Fast es la edición de ByteDance Seed centrada en velocidad de la familia Seedance 2.0. Admite generación conjunta de video y audio y un encargo multimodal formado por texto, imágenes, video y sonido. Sus capacidades creativas incluyen escenas nuevas guiadas por referencias, edición de material existente y extensión de una escena; sus niveles de salida documentados son 480p y 720p.\n\n### Referencia multimodal: asignar funciones al material\n\nUna imagen puede aportar personaje, producto, composición o tratamiento visual. Un video de referencia puede aportar acción, movimiento de cámara o un efecto. El audio puede aportar timbre de voz, melodía musical o contenido del diálogo. Explica qué parte de cada fuente quieres trasladar a la escena nueva; una referencia resulta más útil con una función creativa concreta.\n\nPor ejemplo: «Usa la lámpara de cerámica de Image 1 como producto. Sigue la órbita lenta de cámara de Video 1, pero sitúa la lámpara en un rincón tranquilo de lectura. Usa Audio 1 para el ambiente musical». La salida prevista es una escena nueva que combine apariencia, movimiento y dirección sonora elegidos, en lugar de una imitación indefinida de todos los detalles de las referencias.\n\nLas combinaciones documentadas incluyen imágenes con audio, imágenes con video, video con audio y los tres juntos. No se admiten texto con audio solo ni entrada únicamente de audio. El modelo también admite texto a video y generación basada en imagen con primer fotograma o pareja de primero y último. Cuando un punto final exacto sea central, usa su flujo específico; describir una imagen de referencia como extremo en omni-reference es control indirecto.\n\n### Edición de un video existente\n\nEl modelo puede añadir, eliminar o modificar elementos, sustituir un sujeto y redibujar o reparar partes de una escena. Identifica el video fuente, el objeto a cambiar y los elementos que deben permanecer. Para una adición, describe dónde y cuándo aparece. Para eliminar, identifica el objeto de forma consistente en todo el clip.\n\nUn encargo práctico podría sustituir una botella lisa de una demostración por la de Image 1, conservando movimiento de mano, fondo y trayectoria de cámara de Video 1. Revisa tanto la sustitución como las zonas que deben quedar estables. Las instrucciones claras de conservación facilitan evaluar la edición más que pedir de forma general «mejorar» el material.\n\n### Extensión y conexión de clips\n\nSeedance 2.0 Fast admite extensión hacia adelante o atrás y conexión de dos o tres clips mediante transiciones generadas. Para extender, indica si la nueva acción sucede antes o después del video y descríbela. Para conectar, aporta los clips en el orden previsto y explica el evento visual que los une.\n\nUna extensión sencilla suele devolver la continuación nueva alrededor del material original, sin suponer que se repita todo el clip fuente. Si la salida debe contener el segmento original, dilo. Al completar una transición entre dos o tres videos, el flujo documentado puede combinar contenido original y generado. Esto sirve para unir una vista amplia de producto con un detalle mediante un movimiento de cámara deliberado.\n\n### Salida y diferencias entre ediciones\n\nLa salida documentada de Fast es MP4 a 24 fps, 480p o 720p, profundidad de color de 8 bits y clips de 4–15 segundos. Las relaciones compatibles son 21:9, 16:9, 4:3, 1:1, 3:4 y 9:16. La edición estándar Seedance 2.0 enumera por separado 1080p y 4K; esos niveles no son parte de Fast. La familia 2.0 permite devolver el último fotograma generado, pero no admite el modo independiente de vista previa Draft.\n\nPuede generarse audio con el material u omitirse para un clip silencioso. El audio generado es mono. Los idiomas documentados de instrucciones incluyen inglés, español, indonesio, portugués y japonés. Mantén consistente el idioma hablado en un diálogo; la guía desaconseja mezclar idiomas salvo nombres propios. Para una escena hablada, nombra al hablante y pon la línea entre comillas; después especifica interpretación y efectos pertinentes. Ajusta la interpretación requerida a la duración elegida.\n\n### Preparación de referencias y límites de entrada\n\nLos límites documentados son hasta nueve imágenes, tres videos y tres clips de audio. Este perfil del fabricante no acepta cargas directas de imagen o video de referencia con rostros humanos reales; los retratos usan su flujo compatible de recursos de retrato. Cada clip de video o audio debe durar 2–15 segundos; el video combinado tiene un máximo de 15 segundos y el audio combinado otro máximo independiente de 15 segundos. Los videos usan MP4 o MOV a 24–60 fps y no deben superar 200 MB cada uno. Los audios usan WAV o MP3 y no deben superar 15 MB cada uno. Los formatos de imagen enumerados son JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC y HEIF. Cada imagen debe pesar menos de 30 MB; el cuerpo total de solicitud tiene un límite de 64 MB. En el perfil documentado, ancho y alto de imagen deben estar estrictamente entre 300 y 6,000 píxeles, con relación ancho/alto estrictamente entre 0.4 y 2.5. Los videos permiten 300–6,000 píxeles por dimensión y relaciones de 0.4–2.5, inclusive, con 407,696–8,295,044 píxeles totales. Los videos MP4 o MOV usan H.264/AVC o H.265/HEVC y audio AAC o MP3.\n\nOrdena los recursos y menciónalos consistentemente como Image 1, Video 1 o Audio 1. Usa también el nombre o rasgo distintivo del sujeto visible junto con el número. Ajusta el encuadre de imágenes límite a la relación de aspecto prevista, porque una discrepancia puede recortar la imagen o provocar un cambio brusco. Centra el encargo en los rasgos a transferir, el evento a generar y lo que conservar; una instrucción larga puede dispersar las indicaciones y dejar sin resolver detalles secundarios.\n\n### Plan de tomas, texto y comportamientos conocidos\n\nOrganiza un encargo complejo como Toma 1, Toma 2 y Toma 3, con sujeto, acción, posición y sonido claros para cada una. La guía recomienda un movimiento de cámara por toma y advierte que las marcas de tiempo exactas por toma son inestables. Da a cada personaje una etiqueta estable y algunos rasgos distintivos; cuando importe la identidad facial, usa un retrato claro y una referencia de cuerpo completo separados en vez de una hoja combinada de vistas del personaje.\n\nEl modelo puede generar texto común, incluidos lemas, subtítulos y globos de diálogo, con indicaciones de color, estilo, posición y entrada. Se prefieren caracteres comunes a caracteres raros o símbolos especiales. Revisa las letras en movimiento. Los subtítulos, logotipos y personajes duplicados no deseados son comportamientos documentados; las restricciones explícitas y referencias limpias pueden reducirlos, sin garantizar su ausencia. Más de cuatro personas de referencia se considera un riesgo de estabilidad, no un límite estricto de cantidad de archivos.\n\nLas extensiones repetidas pueden acumular pérdida de calidad de imagen y una unión puede saltar o retroceder. Limita las continuaciones encadenadas y revisa la unión al editar. El timbre de voz de referencia puede variar, la narración puede terminar con un clic y los caracteres chinos polifónicos o poco comunes pueden pronunciarse mal. Revisa la línea hablada y el audio final; un fundido breve de audio puede ayudar con un corte. Estas comprobaciones forman parte de preparar el resultado creativo, especialmente cuando el habla o la continuidad de personajes sostienen la historia.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "a43cd889e97bb6b08ea1972238e58c790b1cf1e1e73122c04a50fe7993f5380e", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "es-mx", "methods": [ { "html": "
•

ByteDance: Seedance 2.0 Fast

ByteDance /bytedance/seedance-2.0-fast

Inicio

ByteDance Seedance 2.0 Fast crea escenas de audio y video a partir de texto y referencias de imagen, video y sonido. Esta edición centrada en velocidad admite transferencia de movimiento y estilo, ediciones de video y extensiones hacia adelante o atrás, con salida documentada de 480p y 720p.

Entradas aceptadas
Texto · Imágenes · Audio
Resultados
Video
Sobre el modelo

Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.

Seedance 2.0 Fast es la edición de ByteDance Seed centrada en velocidad de la familia Seedance 2.0. Admite generación conjunta de video y audio y un encargo multimodal formado por texto, imágenes, video y sonido. Sus capacidades creativas incluyen escenas nuevas guiadas por referencias, edición de material existente y extensión de una escena; sus niveles de salida documentados son 480p y 720p.

Referencia multimodal: asignar funciones al material

Una imagen puede aportar personaje, producto, composición o tratamiento visual. Un video de referencia puede aportar acción, movimiento de cámara o un efecto. El audio puede aportar timbre de voz, melodía musical o contenido del diálogo. Explica qué parte de cada fuente quieres trasladar a la escena nueva; una referencia resulta más útil con una función creativa concreta.

Por ejemplo: «Usa la lámpara de cerámica de Image 1 como producto. Sigue la órbita lenta de cámara de Video 1, pero sitúa la lámpara en un rincón tranquilo de lectura. Usa Audio 1 para el ambiente musical». La salida prevista es una escena nueva que combine apariencia, movimiento y dirección sonora elegidos, en lugar de una imitación indefinida de todos los detalles de las referencias.

Las combinaciones documentadas incluyen imágenes con audio, imágenes con video, video con audio y los tres juntos. No se admiten texto con audio solo ni entrada únicamente de audio. El modelo también admite texto a video y generación basada en imagen con primer fotograma o pareja de primero y último. Cuando un punto final exacto sea central, usa su flujo específico; describir una imagen de referencia como extremo en omni-reference es control indirecto.

Edición de un video existente

El modelo puede añadir, eliminar o modificar elementos, sustituir un sujeto y redibujar o reparar partes de una escena. Identifica el video fuente, el objeto a cambiar y los elementos que deben permanecer. Para una adición, describe dónde y cuándo aparece. Para eliminar, identifica el objeto de forma consistente en todo el clip.

Un encargo práctico podría sustituir una botella lisa de una demostración por la de Image 1, conservando movimiento de mano, fondo y trayectoria de cámara de Video 1. Revisa tanto la sustitución como las zonas que deben quedar estables. Las instrucciones claras de conservación facilitan evaluar la edición más que pedir de forma general «mejorar» el material.

Extensión y conexión de clips

Seedance 2.0 Fast admite extensión hacia adelante o atrás y conexión de dos o tres clips mediante transiciones generadas. Para extender, indica si la nueva acción sucede antes o después del video y descríbela. Para conectar, aporta los clips en el orden previsto y explica el evento visual que los une.

Una extensión sencilla suele devolver la continuación nueva alrededor del material original, sin suponer que se repita todo el clip fuente. Si la salida debe contener el segmento original, dilo. Al completar una transición entre dos o tres videos, el flujo documentado puede combinar contenido original y generado. Esto sirve para unir una vista amplia de producto con un detalle mediante un movimiento de cámara deliberado.

Salida y diferencias entre ediciones

La salida documentada de Fast es MP4 a 24 fps, 480p o 720p, profundidad de color de 8 bits y clips de 4–15 segundos. Las relaciones compatibles son 21:9, 16:9, 4:3, 1:1, 3:4 y 9:16. La edición estándar Seedance 2.0 enumera por separado 1080p y 4K; esos niveles no son parte de Fast. La familia 2.0 permite devolver el último fotograma generado, pero no admite el modo independiente de vista previa Draft.

Puede generarse audio con el material u omitirse para un clip silencioso. El audio generado es mono. Los idiomas documentados de instrucciones incluyen inglés, español, indonesio, portugués y japonés. Mantén consistente el idioma hablado en un diálogo; la guía desaconseja mezclar idiomas salvo nombres propios. Para una escena hablada, nombra al hablante y pon la línea entre comillas; después especifica interpretación y efectos pertinentes. Ajusta la interpretación requerida a la duración elegida.

Preparación de referencias y límites de entrada

Los límites documentados son hasta nueve imágenes, tres videos y tres clips de audio. Este perfil del fabricante no acepta cargas directas de imagen o video de referencia con rostros humanos reales; los retratos usan su flujo compatible de recursos de retrato. Cada clip de video o audio debe durar 2–15 segundos; el video combinado tiene un máximo de 15 segundos y el audio combinado otro máximo independiente de 15 segundos. Los videos usan MP4 o MOV a 24–60 fps y no deben superar 200 MB cada uno. Los audios usan WAV o MP3 y no deben superar 15 MB cada uno. Los formatos de imagen enumerados son JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC y HEIF. Cada imagen debe pesar menos de 30 MB; el cuerpo total de solicitud tiene un límite de 64 MB. En el perfil documentado, ancho y alto de imagen deben estar estrictamente entre 300 y 6,000 píxeles, con relación ancho/alto estrictamente entre 0.4 y 2.5. Los videos permiten 300–6,000 píxeles por dimensión y relaciones de 0.4–2.5, inclusive, con 407,696–8,295,044 píxeles totales. Los videos MP4 o MOV usan H.264/AVC o H.265/HEVC y audio AAC o MP3.

Ordena los recursos y menciónalos consistentemente como Image 1, Video 1 o Audio 1. Usa también el nombre o rasgo distintivo del sujeto visible junto con el número. Ajusta el encuadre de imágenes límite a la relación de aspecto prevista, porque una discrepancia puede recortar la imagen o provocar un cambio brusco. Centra el encargo en los rasgos a transferir, el evento a generar y lo que conservar; una instrucción larga puede dispersar las indicaciones y dejar sin resolver detalles secundarios.

Plan de tomas, texto y comportamientos conocidos

Organiza un encargo complejo como Toma 1, Toma 2 y Toma 3, con sujeto, acción, posición y sonido claros para cada una. La guía recomienda un movimiento de cámara por toma y advierte que las marcas de tiempo exactas por toma son inestables. Da a cada personaje una etiqueta estable y algunos rasgos distintivos; cuando importe la identidad facial, usa un retrato claro y una referencia de cuerpo completo separados en vez de una hoja combinada de vistas del personaje.

El modelo puede generar texto común, incluidos lemas, subtítulos y globos de diálogo, con indicaciones de color, estilo, posición y entrada. Se prefieren caracteres comunes a caracteres raros o símbolos especiales. Revisa las letras en movimiento. Los subtítulos, logotipos y personajes duplicados no deseados son comportamientos documentados; las restricciones explícitas y referencias limpias pueden reducirlos, sin garantizar su ausencia. Más de cuatro personas de referencia se considera un riesgo de estabilidad, no un límite estricto de cantidad de archivos.

Las extensiones repetidas pueden acumular pérdida de calidad de imagen y una unión puede saltar o retroceder. Limita las continuaciones encadenadas y revisa la unión al editar. El timbre de voz de referencia puede variar, la narración puede terminar con un clic y los caracteres chinos polifónicos o poco comunes pueden pronunciarse mal. Revisa la línea hablada y el audio final; un fundido breve de audio puede ayudar con un corte. Estas comprobaciones forman parte de preparar el resultado creativo, especialmente cuando el habla o la continuidad de personajes sostienen la historia.

Disponible en Ailoot · entradas y métodos

Ailoot Ultra · Video POST /v1/videos
Entrada
text, image, audio
Salida
video
Formato de salida
bytes MP4 originales; sin normalización ni transcodificación
CampoTipoRequisitoValores y límitesPredeterminado
CampomodelTipostringRequisitoObligatorioValores y límites
bytedance/seedance-2.0-fast
Predeterminado—
CampopromptTipostringRequisitoObligatorioValores y límitesPredeterminado—
CampodurationTipointegerRequisitoObligatorioValores y límites
4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Mínimo: 1
Máximo: 600
Predeterminado—
CamporesolutionTipostringRequisitoOpcionalValores y límites
480p, 720p
Predeterminado—
Campoaspect_ratioTipostringRequisitoOpcionalValores y límites
1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21
Predeterminado—
Campogenerate_audioTipobooleanRequisitoOpcionalValores y límites
false, true
Condiciones: Omitir generate_audio selecciona el precio con audio; false selecciona el precio sin audio. Revisa has_audio en el resultado para saber si se devolvió una pista de audio.
Predeterminado—
Campoframe_imagesTipoarrayRequisitoOpcionalValores y límites
Número mínimo de elementos: 1
Número máximo de elementos: 2
Contenido de entrada: Arreglo de objetos de fotograma. Cada uno tiene type=image_url, image_url que contiene url y frame_type=first_frame o last_frame. Cada función puede aparecer como máximo una vez. Usa URL HTTPS públicas.
Claves exactas: type, image_url, frame_type
Condiciones: Estas claves se aplican a cada objeto de fotograma. Omite frame_images para una solicitud de solo texto.
Predeterminado—
Campoinput_referencesTipoarrayRequisitoOpcionalValores y límites
Contenido de entrada: Arreglo de objetos de referencia de imagen o audio. Establece type en image_url o audio_url y proporciona el objeto URL correspondiente que contiene url. Las referencias de video siguen sin poder cotizarse.
Condiciones: Omite frame_images para usar el modo de referencias. Usa URL HTTPS públicas.
Predeterminado—
CamposizeTipostringRequisitoOpcionalValores y límites
480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720
Patrón: ^[1-9][0-9]*x[1-9][0-9]*$
Predeterminado—
CamposeedTipointegerRequisitoOpcionalValores y límites
Mínimo: -9,223,372,036,854,775,808
Máximo: 9,223,372,036,854,775,807
Predeterminado—
Campocallback_urlTipostringRequisitoOpcionalValores y límites
Patrón: ^https://
Predeterminado—
Camposession_idTipostringRequisitoOpcionalValores y límitesPredeterminado—
CampotraceTipoobjectRequisitoOpcionalValores y límitesPredeterminado—
CampouserTipostringRequisitoOpcionalValores y límitesPredeterminado—
Combinaciones de materiales de entrada

Texto a video · Una instrucción escrita. · Obligatorio: model, prompt, duration

Proporciona una instrucción de texto y una duración compatible en segundos enteros. Usa un tamaño exacto de la lista o una resolución y relación de aspecto que correspondan a las dimensiones enumeradas.

model: Tipo: string · bytedance/seedance-2.0-fast

prompt: Tipo: string · Máximo de bytes UTF-8: 10,000 · Se requiere contenido distinto de espacios en blanco: Sí

Imagen a video · Una instrucción escrita y una imagen de fotograma. · Obligatorio: model, prompt, duration, frame_images

frame_images es un arreglo de objetos con type=image_url, image_url que contiene url y frame_type. Usa una URL HTTPS pública de imagen; first_frame y last_frame pueden aparecer una vez cada uno. Usa un tamaño de salida enumerado o dimensiones compatibles. No agregues referencias de video.

Claves exactas: type, image_url, frame_type

model: Tipo: string · bytedance/seedance-2.0-fast

prompt: Tipo: string · Máximo de bytes UTF-8: 10,000 · Se requiere contenido distinto de espacios en blanco: Sí

Reference to video · Una instrucción escrita y referencias de imagen o audio. · Obligatorio: model, prompt, duration, input_references

input_references es un arreglo. Cada objeto tiene type=image_url o type=audio_url y un objeto URL correspondiente que contiene url. Usa enlaces HTTPS públicos. Omite frame_images para seleccionar el modo de referencias. Las referencias de video no pueden cotizarse.

model: Tipo: string · bytedance/seedance-2.0-fast

prompt: Tipo: string · Máximo de bytes UTF-8: 10,000 · Se requiere contenido distinto de espacios en blanco: Sí

Parámetros del método y ciclo de vida
ParámetroContrato
Parámetrocontent_typeContratoapplication/json
ParámetrorequiredContratomodel, prompt, duration
Parámetromaterial_typesContratotext, image, audio
Parámetroadditional_propertiesContratofalse
Parámetrooptional_controlsContratoresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user

Ciclo de vida: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

Tarifas

Cómo se calcula el cargo definitivo

Las tarifas mostradas permiten estimar el costo antes de la generación. El cargo final se calcula a partir del costo registrado para la generación original. La duración medida de la salida y las cantidades estimadas no son la cantidad facturable final.

Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.

Modo fast
Sin especificar Cuando se selecciona el modo fast
Modo flex
Sin especificar Cuando se selecciona el modo flex
Esfuerzo máximo de razonamiento
Sin especificar Cuando el esfuerzo máximo de razonamiento usa el ajuste default

Tarifas estimadas para comparar

Precios por configuración

Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.

ConfiguraciónTabla de tarifasCantidad previstaUnidad de facturaciónCondiciones de facturaciónCargo
ConfiguraciónTarifas base por tokenTabla de tarifasTarifa baseCantidad prevista—Unidad de facturación—Condiciones de facturación—Cargo
Entrada · Tokens de entrada · Estimación solo para comparar — / 1K tokens
Salida · Tokens de salida · Estimación solo para comparar — / 1K tokens
Entrada · Lectura de caché · Estimación solo para comparar — / 1K tokens
Entrada · Escritura en caché · Estimación solo para comparar — / 1K tokens
Entrada · Escritura en caché, 1 hora · Estimación solo para comparar — / 1K tokens
ConfiguraciónPrecio por token de videoTabla de tarifas—Cantidad prevista—Unidad de facturaciónpor 1K tokens de videoCondiciones de facturaciónNo se declara ninguna condición adicional en esta clave de precios.Cargo
Salida · Precio por token de video · Estimación solo para comparar $0.0084 por 1K tokens de video

La tarifa por tokens de video es la referencia principal de precio. Las estimaciones destacadas por segundo son referencias independientes, no un cargo adicional.

ConfiguraciónPrecio por token de videoTabla de tarifas—Cantidad prevista—Unidad de facturaciónpor 1K tokens de videoCondiciones de facturaciónentrada: with_video_inputCargo
reference · Precio por token de video · Estimación solo para comparar $0.00495 por 1K tokens de video

La tarifa por tokens de video es la referencia principal de precio. Las estimaciones destacadas por segundo son referencias independientes, no un cargo adicional.

ConfiguraciónPrecio por token de videoTabla de tarifas—Cantidad prevista—Unidad de facturaciónpor 1K tokens de videoCondiciones de facturaciónconfiguración de audio: without_audioCargo
Salida · Precio por token de video · Estimación solo para comparar $0.0084 por 1K tokens de video

La tarifa por tokens de video es la referencia principal de precio. Las estimaciones destacadas por segundo son referencias independientes, no un cargo adicional.

ConfiguraciónCosto estimado de generaciónTabla de tarifas—Cantidad previstaestimación para una generaciónUnidad de facturación—Condiciones de facturación—Cargo
Salida · Costo estimado de generación · Estimación solo para comparar $0.18144 estimación previa a la generación

Esta estimación no es un cargo adicional ni una tarifa fija por la generación completada.

Ailoot reserva un monto estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →

Detalles de la tarifa de referencia

Las tablas de referencia del modelo no cambian la selección del método, las cotizaciones ni los cargos. Los cargos aplicados usan las tarifas del método Ailoot seleccionado.

Referencias de precios por configuración de video

Precios por configuración

Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.

ConfiguraciónCondiciones de facturaciónCargo
ConfiguraciónPrecio por token de videoCondiciones de facturaciónNo se declara ninguna condición adicional en esta clave de precios.Cargo
Salida · Precio por token de video $0.0084 por 1K tokens de video

La tarifa por tokens de video es la referencia principal de precio. Las estimaciones destacadas por segundo son referencias independientes, no un cargo adicional.

ConfiguraciónPrecio por token de videoCondiciones de facturaciónconfiguración de audio: without_audioCargo
Salida · Precio por token de video $0.0084 por 1K tokens de video

La tarifa por tokens de video es la referencia principal de precio. Las estimaciones destacadas por segundo son referencias independientes, no un cargo adicional.

ConfiguraciónPrecio por token de videoCondiciones de facturaciónentrada: with_video_inputCargo
reference · Precio por token de video $0.00495 por 1K tokens de video

La tarifa por tokens de video es la referencia principal de precio. Las estimaciones destacadas por segundo son referencias independientes, no un cargo adicional.

Solicitudes de ejemplo

Ailoot Ultra · Video

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{"model":"bytedance/seedance-2.0-fast","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"480x480","generate_audio":false}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n

Recibir y guardar resultados

Ailoot Ultra · Video

URL firmadas de contenido que te pertenece

Consultar el estado de la tarea
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n
Otras consultas de contenido
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n    urls.append((str(i),u))\nfor label,path in urls:\n    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n    target=Path('owned-'+label+'.bin')\n    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n
Conserva todos los resultados completados

Guarda todos los videos completados o archivos recibidos; descarga cada URL de archivo que se haya devuelto.

Conserva cada salida real que te pertenezca y los metadatos medidos que se devuelvan con ella.

Si es necesario revisar la respuesta original

503 result_pending_check + id original + X-Should-Retry:false; nunca repitas el envío original

Campos de respuesta
CampoTipoSignificado
CampoindexTipointegerSignificadoPosición de este video en la lista de salidas, con índice que comienza en cero.
Campocontent_urlTipostringSignificadoURL HTTPS firmada de descarga de este video completado.
Camposha256Tipostring | nullSignificadoResumen SHA-256 de los bytes del video original; null si no está disponible.
Camposize_bytesTipointeger | nullSignificadoTamaño del archivo de video original en bytes; null si no está disponible.
Campoduration_msTipointeger | nullSignificadoDuración medida del video en milisegundos; null si no está disponible.
CampowidthTipointeger | nullSignificadoAncho del video en píxeles; null si no está disponible.
CampoheightTipointeger | nullSignificadoAlto del video en píxeles; null si no está disponible.
Campovideo_codecTipostring | nullSignificadoIdentificador del códec de video; null si no se registró.
Campohas_audioTipoboolean | nullSignificadoIndica si el video contiene una pista de audio; null si no se midió.
Campoaudio_codecTipostring | nullSignificadoIdentificador del códec de audio; null cuando no se registra ningún identificador.
Errores y siguientes pasos
RespuestaCondiciónSiguiente paso
Respuesta404 · not_found_errorCondiciónEl acceso al video no está disponible o no se encontró este ID de video.Siguiente pasoVerifica el acceso al video. Para un video existente, usa su ID público original y la misma clave API.
Respuesta401 · authentication_errorCondiciónLa clave API no coincide con la cuenta autenticada.Siguiente pasoRevisa tu clave API y el acceso de tu cuenta antes de enviar.
Respuesta400 · invalid_request_errorCondiciónNo se pudo leer la solicitud o el índice de descarga no es válido.Siguiente pasoCorrige el cuerpo de la solicitud. Para una descarga, elige un índice de salida devuelto por la tarea original.
Respuesta422 · price_unavailableCondiciónNo se puede cotizar la configuración de video seleccionada.Siguiente pasoElige una configuración de video compatible y completa sus opciones obligatorias antes de enviar una solicitud corregida.
Respuesta422 · invalid_request_errorCondiciónUna entrada de video o la tarea original de continuación no es válida.Siguiente pasoUsa entradas HTTPS válidas. Para una continuación, usa el ID público de tu video original completado con la misma clave API.
Respuesta402 · billing_errorCondiciónEl saldo disponible o los límites no permiten reservar fondos.Siguiente pasoRevisa tu saldo disponible y tus límites antes de enviar una solicitud nueva.
Respuesta503 · server_errorCondiciónLa verificación del video, el almacenamiento o el acceso al servicio no están disponibles temporalmente.Siguiente pasoEspera a que el servicio esté disponible. Si ya tienes un ID de video, consulta esa tarea original en lugar de crear otra generación.
Respuesta503 · result_pending_checkCondiciónEl resultado y el cargo del video original requieren verificación.Siguiente pasoConserva el ID de video devuelto y consulta esa tarea. No envíes una solicitud de generación de reemplazo mientras se verifica.
Respuesta503 · owned_result_unavailableCondiciónLa descarga del video existente no está disponible temporalmente.Siguiente pasoConsulta más tarde la misma tarea de video y descarga su salida existente. Una generación nueva crea una operación independiente.
Respuesta409 · video_not_readyCondiciónEl contenido del video no se ha publicado.Siguiente pasoConsulta el estado de la tarea original. Descarga cuando indique completed; si indica failed, sigue su aviso de verificación del cargo.

Alias

Alias del modelo

Ailoot Ultra bytedance/seedance-2.0-fast

Alias de rutas de métodos

Usa las rutas de método indicadas arriba.

ID de modelo relacionados

bytedance/seedance-2.0-fast

", "method_identity": { "effective_request_model_id": "bytedance/seedance-2.0-fast", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "bytedance/seedance-2.0-fast", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|bytedance%2Fseedance-2.0-fast", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Las tarifas mostradas permiten estimar el costo antes de la generación. El cargo final se calcula a partir del costo registrado para la generación original. La duración medida de la salida y las cantidades estimadas no son la cantidad facturable final.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Conserva cada salida real que te pertenezca y los metadatos medidos que se devuelvan con ella.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "El acceso al video no está disponible o no se encontró este ID de video.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Verifica el acceso al video. Para un video existente, usa su ID público original y la misma clave API.", "type": "not_found_error" }, { "condition": "La clave API no coincide con la cuenta autenticada.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Revisa tu clave API y el acceso de tu cuenta antes de enviar.", "type": "authentication_error" }, { "condition": "No se pudo leer la solicitud o el índice de descarga no es válido.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Corrige el cuerpo de la solicitud. Para una descarga, elige un índice de salida devuelto por la tarea original.", "type": "invalid_request_error" }, { "condition": "No se puede cotizar la configuración de video seleccionada.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Elige una configuración de video compatible y completa sus opciones obligatorias antes de enviar una solicitud corregida.", "type": "price_unavailable" }, { "condition": "Una entrada de video o la tarea original de continuación no es válida.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Usa entradas HTTPS válidas. Para una continuación, usa el ID público de tu video original completado con la misma clave API.", "type": "invalid_request_error" }, { "condition": "El saldo disponible o los límites no permiten reservar fondos.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Revisa tu saldo disponible y tus límites antes de enviar una solicitud nueva.", "type": "billing_error" }, { "condition": "La verificación del video, el almacenamiento o el acceso al servicio no están disponibles temporalmente.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Espera a que el servicio esté disponible. Si ya tienes un ID de video, consulta esa tarea original en lugar de crear otra generación.", "type": "server_error" }, { "code": "result_pending_check", "condition": "El resultado y el cargo del video original requieren verificación.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Conserva el ID de video devuelto y consulta esa tarea. No envíes una solicitud de generación de reemplazo mientras se verifica.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "La descarga del video existente no está disponible temporalmente.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Consulta más tarde la misma tarea de video y descarga su salida existente. Una generación nueva crea una operación independiente.", "type": "server_error" }, { "condition": "El contenido del video no se ha publicado.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Consulta el estado de la tarea original. Descarga cuando indique completed; si indica failed, sigue su aviso de verificación del cargo.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + id original + X-Should-Retry:false; nunca repitas el envío original" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Proporciona una instrucción de texto y una duración compatible en segundos enteros. Usa un tamaño exacto de la lista o una resolución y relación de aspecto que correspondan a las dimensiones enumeradas.", "required": [ "model", "prompt", "duration" ], "required_material": "Una instrucción escrita." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images es un arreglo de objetos con type=image_url, image_url que contiene url y frame_type. Usa una URL HTTPS pública de imagen; first_frame y last_frame pueden aparecer una vez cada uno. Usa un tamaño de salida enumerado o dimensiones compatibles. No agregues referencias de video.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Una instrucción escrita y una imagen de fotograma." }, { "mode": "Reference to video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references es un arreglo. Cada objeto tiene type=image_url o type=audio_url y un objeto URL correspondiente que contiene url. Usa enlaces HTTPS públicos. Omite frame_images para seleccionar el modo de referencias. Las referencias de video no pueden cotizarse.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Una instrucción escrita y referencias de imagen o audio." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Posición de este video en la lista de salidas, con índice que comienza en cero.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "URL HTTPS firmada de descarga de este video completado.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Resumen SHA-256 de los bytes del video original; null si no está disponible.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Tamaño del archivo de video original en bytes; null si no está disponible.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Duración medida del video en milisegundos; null si no está disponible.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Ancho del video en píxeles; null si no está disponible.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Alto del video en píxeles; null si no está disponible.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Identificador del códec de video; null si no se registró.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Indica si el video contiene una pista de audio; null si no se midió.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Identificador del códec de audio; null cuando no se registra ningún identificador.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "URL firmadas de contenido que te pertenece", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "bytedance/seedance-2.0-fast" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480p", "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "480p", "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "type": "string" }, { "availability": "source_interface", "conditions": "Omitir generate_audio selecciona el precio con audio; false selecciona el precio sin audio. Revisa has_audio en el resultado para saber si se devolvió una pista de audio.", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Estas claves se aplican a cada objeto de fotograma. Omite frame_images para una solicitud de solo texto.", "content": "Arreglo de objetos de fotograma. Cada uno tiene type=image_url, image_url que contiene url y frame_type=first_frame o last_frame. Cada función puede aparecer como máximo una vez. Usa URL HTTPS públicas.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "conditions": "Omite frame_images para usar el modo de referencias. Usa URL HTTPS públicas.", "content": "Arreglo de objetos de referencia de imagen o audio. Establece type en image_url o audio_url y proporciona el objeto URL correspondiente que contiene url. Las referencias de video siguen sin poder cotizarse.", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 9223372036854775807, "minimum": -9223372036854775808, "name": "seed", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "bytedance/seedance-2.0-fast" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "480p", "720p" ] }, "seed": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Request geometry is required for the pre-generation estimate and reserve. Returned geometry and track time describe the generated output; final charge follows the actual billed configuration.", "Video references with *_with_video_input quantity are rejected; image/audio references only where model reference types admit them." ] }, "unsupported": [ "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "seed", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "La tarifa por tokens de video es la referencia principal de precio. Las estimaciones destacadas por segundo son referencias independientes, no un cargo adicional.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Precio por token de video", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "La tarifa por tokens de video es la referencia principal de precio. Las estimaciones destacadas por segundo son referencias independientes, no un cargo adicional.", "dimensions": { "conditions": "entrada: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Precio por token de video", "units": [ { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "Esta estimación no es un cargo adicional ni una tarifa fija por la generación completada.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Costo estimado de generación", "units": [ { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"model\":\"bytedance/seedance-2.0-fast\",\"prompt\":\"A serene mountain landscape at sunset\",\"duration\":4,\"resolution\":\"480p\",\"size\":\"480x480\",\"generate_audio\":false}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image", "audio" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "input: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "bytedance/seedance-2.0-fast", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" }, { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "bytedance/seedance-2.0-fast", "nativeProvenance": { "input_facts_canonical_sha256": "9623ecea059993c85c5ebe35984ac03defc3e084cc7581f70ba032b1498ad608", "input_html_sha256": "a518a3d806cb8ca572e09407e7af6ddf0a176104fae3f3c5893f7ae6e2c56e1b", "private_audit_sha256": "6a0410f7cb1225ca8b3d99efe52bc7fc88358aa5e8fc58654b24c4bc367413c3", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/es-mx/bytedance-seedance-2-0-fast/", "description": "ByteDance Seedance 2.0 Fast crea escenas de audio y video a partir de texto y referencias de imagen, video y sonido. Esta edición centrada en velocidad admite transferencia de movimiento y estilo, ediciones de video y extensiones hacia adelante o atrás, con salida documentada de 480p y 720p.", "locale": "es-mx", "md_url": "https://ailoot.ai/models/es-mx/bytedance-seedance-2-0-fast/index.md", "title": "ByteDance: Seedance 2.0 Fast — Ailoot", "url": "https://ailoot.ai/models/es-mx/bytedance-seedance-2-0-fast/" }, "rawModel": { "about": "Seedance 2.0 Fast es la edición de ByteDance Seed centrada en velocidad de la familia Seedance 2.0. Admite generación conjunta de video y audio y un encargo multimodal formado por texto, imágenes, video y sonido. Sus capacidades creativas incluyen escenas nuevas guiadas por referencias, edición de material existente y extensión de una escena; sus niveles de salida documentados son 480p y 720p.\n\n### Referencia multimodal: asignar funciones al material\n\nUna imagen puede aportar personaje, producto, composición o tratamiento visual. Un video de referencia puede aportar acción, movimiento de cámara o un efecto. El audio puede aportar timbre de voz, melodía musical o contenido del diálogo. Explica qué parte de cada fuente quieres trasladar a la escena nueva; una referencia resulta más útil con una función creativa concreta.\n\nPor ejemplo: «Usa la lámpara de cerámica de Image 1 como producto. Sigue la órbita lenta de cámara de Video 1, pero sitúa la lámpara en un rincón tranquilo de lectura. Usa Audio 1 para el ambiente musical». La salida prevista es una escena nueva que combine apariencia, movimiento y dirección sonora elegidos, en lugar de una imitación indefinida de todos los detalles de las referencias.\n\nLas combinaciones documentadas incluyen imágenes con audio, imágenes con video, video con audio y los tres juntos. No se admiten texto con audio solo ni entrada únicamente de audio. El modelo también admite texto a video y generación basada en imagen con primer fotograma o pareja de primero y último. Cuando un punto final exacto sea central, usa su flujo específico; describir una imagen de referencia como extremo en omni-reference es control indirecto.\n\n### Edición de un video existente\n\nEl modelo puede añadir, eliminar o modificar elementos, sustituir un sujeto y redibujar o reparar partes de una escena. Identifica el video fuente, el objeto a cambiar y los elementos que deben permanecer. Para una adición, describe dónde y cuándo aparece. Para eliminar, identifica el objeto de forma consistente en todo el clip.\n\nUn encargo práctico podría sustituir una botella lisa de una demostración por la de Image 1, conservando movimiento de mano, fondo y trayectoria de cámara de Video 1. Revisa tanto la sustitución como las zonas que deben quedar estables. Las instrucciones claras de conservación facilitan evaluar la edición más que pedir de forma general «mejorar» el material.\n\n### Extensión y conexión de clips\n\nSeedance 2.0 Fast admite extensión hacia adelante o atrás y conexión de dos o tres clips mediante transiciones generadas. Para extender, indica si la nueva acción sucede antes o después del video y descríbela. Para conectar, aporta los clips en el orden previsto y explica el evento visual que los une.\n\nUna extensión sencilla suele devolver la continuación nueva alrededor del material original, sin suponer que se repita todo el clip fuente. Si la salida debe contener el segmento original, dilo. Al completar una transición entre dos o tres videos, el flujo documentado puede combinar contenido original y generado. Esto sirve para unir una vista amplia de producto con un detalle mediante un movimiento de cámara deliberado.\n\n### Salida y diferencias entre ediciones\n\nLa salida documentada de Fast es MP4 a 24 fps, 480p o 720p, profundidad de color de 8 bits y clips de 4–15 segundos. Las relaciones compatibles son 21:9, 16:9, 4:3, 1:1, 3:4 y 9:16. La edición estándar Seedance 2.0 enumera por separado 1080p y 4K; esos niveles no son parte de Fast. La familia 2.0 permite devolver el último fotograma generado, pero no admite el modo independiente de vista previa Draft.\n\nPuede generarse audio con el material u omitirse para un clip silencioso. El audio generado es mono. Los idiomas documentados de instrucciones incluyen inglés, español, indonesio, portugués y japonés. Mantén consistente el idioma hablado en un diálogo; la guía desaconseja mezclar idiomas salvo nombres propios. Para una escena hablada, nombra al hablante y pon la línea entre comillas; después especifica interpretación y efectos pertinentes. Ajusta la interpretación requerida a la duración elegida.\n\n### Preparación de referencias y límites de entrada\n\nLos límites documentados son hasta nueve imágenes, tres videos y tres clips de audio. Este perfil del fabricante no acepta cargas directas de imagen o video de referencia con rostros humanos reales; los retratos usan su flujo compatible de recursos de retrato. Cada clip de video o audio debe durar 2–15 segundos; el video combinado tiene un máximo de 15 segundos y el audio combinado otro máximo independiente de 15 segundos. Los videos usan MP4 o MOV a 24–60 fps y no deben superar 200 MB cada uno. Los audios usan WAV o MP3 y no deben superar 15 MB cada uno. Los formatos de imagen enumerados son JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC y HEIF. Cada imagen debe pesar menos de 30 MB; el cuerpo total de solicitud tiene un límite de 64 MB. En el perfil documentado, ancho y alto de imagen deben estar estrictamente entre 300 y 6,000 píxeles, con relación ancho/alto estrictamente entre 0.4 y 2.5. Los videos permiten 300–6,000 píxeles por dimensión y relaciones de 0.4–2.5, inclusive, con 407,696–8,295,044 píxeles totales. Los videos MP4 o MOV usan H.264/AVC o H.265/HEVC y audio AAC o MP3.\n\nOrdena los recursos y menciónalos consistentemente como Image 1, Video 1 o Audio 1. Usa también el nombre o rasgo distintivo del sujeto visible junto con el número. Ajusta el encuadre de imágenes límite a la relación de aspecto prevista, porque una discrepancia puede recortar la imagen o provocar un cambio brusco. Centra el encargo en los rasgos a transferir, el evento a generar y lo que conservar; una instrucción larga puede dispersar las indicaciones y dejar sin resolver detalles secundarios.\n\n### Plan de tomas, texto y comportamientos conocidos\n\nOrganiza un encargo complejo como Toma 1, Toma 2 y Toma 3, con sujeto, acción, posición y sonido claros para cada una. La guía recomienda un movimiento de cámara por toma y advierte que las marcas de tiempo exactas por toma son inestables. Da a cada personaje una etiqueta estable y algunos rasgos distintivos; cuando importe la identidad facial, usa un retrato claro y una referencia de cuerpo completo separados en vez de una hoja combinada de vistas del personaje.\n\nEl modelo puede generar texto común, incluidos lemas, subtítulos y globos de diálogo, con indicaciones de color, estilo, posición y entrada. Se prefieren caracteres comunes a caracteres raros o símbolos especiales. Revisa las letras en movimiento. Los subtítulos, logotipos y personajes duplicados no deseados son comportamientos documentados; las restricciones explícitas y referencias limpias pueden reducirlos, sin garantizar su ausencia. Más de cuatro personas de referencia se considera un riesgo de estabilidad, no un límite estricto de cantidad de archivos.\n\nLas extensiones repetidas pueden acumular pérdida de calidad de imagen y una unión puede saltar o retroceder. Limita las continuaciones encadenadas y revisa la unión al editar. El timbre de voz de referencia puede variar, la narración puede terminar con un clic y los caracteres chinos polifónicos o poco comunes pueden pronunciarse mal. Revisa la línea hablada y el audio final; un fundido breve de audio puede ayudar con un corte. Estas comprobaciones forman parte de preparar el resultado creativo, especialmente cuando el habla o la continuidad de personajes sostienen la historia.", "alias_of": null, "aliases": [], "author": "ByteDance", "available": null, "canonical_model": "bytedance/seedance-2.0-fast", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image", "video", "audio" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Consulta los precios completos de la configuración en los detalles." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "24999f354c53561f1fcfc3f1", "label": "Referencias de precios por configuración de video", "profiles": [ { "basis": "La tarifa por tokens de video es la referencia principal de precio. Las estimaciones destacadas por segundo son referencias independientes, no un cargo adicional.", "dimensions": { "conditions": "No se declara ninguna condición adicional en esta clave de precios." }, "label": "Precio por token de video", "units": [ { "amount": "0.0084", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "out", "unit": "video_token" } ] }, { "basis": "La tarifa por tokens de video es la referencia principal de precio. Las estimaciones destacadas por segundo son referencias independientes, no un cargo adicional.", "dimensions": { "conditions": "configuración de audio: without_audio" }, "label": "Precio por token de video", "units": [ { "amount": "0.0084", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "out", "unit": "video_token" } ] }, { "basis": "La tarifa por tokens de video es la referencia principal de precio. Las estimaciones destacadas por segundo son referencias independientes, no un cargo adicional.", "dimensions": { "conditions": "entrada: with_video_input" }, "label": "Precio por token de video", "units": [ { "amount": "0.00495", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "reference", "unit": "video_token" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "bytedance/seedance-2.0-fast", "input": [ "text", "image", "audio" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Las tarifas mostradas permiten estimar el costo antes de la generación. El cargo final se calcula a partir del costo registrado para la generación original. La duración medida de la salida y las cantidades estimadas no son la cantidad facturable final.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Conserva cada salida real que te pertenezca y los metadatos medidos que se devuelvan con ella.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "El acceso al video no está disponible o no se encontró este ID de video.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Verifica el acceso al video. Para un video existente, usa su ID público original y la misma clave API.", "type": "not_found_error" }, { "condition": "La clave API no coincide con la cuenta autenticada.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Revisa tu clave API y el acceso de tu cuenta antes de enviar.", "type": "authentication_error" }, { "condition": "No se pudo leer la solicitud o el índice de descarga no es válido.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Corrige el cuerpo de la solicitud. Para una descarga, elige un índice de salida devuelto por la tarea original.", "type": "invalid_request_error" }, { "condition": "No se puede cotizar la configuración de video seleccionada.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Elige una configuración de video compatible y completa sus opciones obligatorias antes de enviar una solicitud corregida.", "type": "price_unavailable" }, { "condition": "Una entrada de video o la tarea original de continuación no es válida.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Usa entradas HTTPS válidas. Para una continuación, usa el ID público de tu video original completado con la misma clave API.", "type": "invalid_request_error" }, { "condition": "El saldo disponible o los límites no permiten reservar fondos.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Revisa tu saldo disponible y tus límites antes de enviar una solicitud nueva.", "type": "billing_error" }, { "condition": "La verificación del video, el almacenamiento o el acceso al servicio no están disponibles temporalmente.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Espera a que el servicio esté disponible. Si ya tienes un ID de video, consulta esa tarea original en lugar de crear otra generación.", "type": "server_error" }, { "code": "result_pending_check", "condition": "El resultado y el cargo del video original requieren verificación.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Conserva el ID de video devuelto y consulta esa tarea. No envíes una solicitud de generación de reemplazo mientras se verifica.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "La descarga del video existente no está disponible temporalmente.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Consulta más tarde la misma tarea de video y descarga su salida existente. Una generación nueva crea una operación independiente.", "type": "server_error" }, { "condition": "El contenido del video no se ha publicado.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Consulta el estado de la tarea original. Descarga cuando indique completed; si indica failed, sigue su aviso de verificación del cargo.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + id original + X-Should-Retry:false; nunca repitas el envío original" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Proporciona una instrucción de texto y una duración compatible en segundos enteros. Usa un tamaño exacto de la lista o una resolución y relación de aspecto que correspondan a las dimensiones enumeradas.", "required": [ "model", "prompt", "duration" ], "required_material": "Una instrucción escrita." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images es un arreglo de objetos con type=image_url, image_url que contiene url y frame_type. Usa una URL HTTPS pública de imagen; first_frame y last_frame pueden aparecer una vez cada uno. Usa un tamaño de salida enumerado o dimensiones compatibles. No agregues referencias de video.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Una instrucción escrita y una imagen de fotograma." }, { "mode": "Reference to video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references es un arreglo. Cada objeto tiene type=image_url o type=audio_url y un objeto URL correspondiente que contiene url. Usa enlaces HTTPS públicos. Omite frame_images para seleccionar el modo de referencias. Las referencias de video no pueden cotizarse.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Una instrucción escrita y referencias de imagen o audio." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Posición de este video en la lista de salidas, con índice que comienza en cero.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "URL HTTPS firmada de descarga de este video completado.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Resumen SHA-256 de los bytes del video original; null si no está disponible.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Tamaño del archivo de video original en bytes; null si no está disponible.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Duración medida del video en milisegundos; null si no está disponible.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Ancho del video en píxeles; null si no está disponible.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Alto del video en píxeles; null si no está disponible.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Identificador del códec de video; null si no se registró.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Indica si el video contiene una pista de audio; null si no se midió.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Identificador del códec de audio; null cuando no se registra ningún identificador.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "URL firmadas de contenido que te pertenece", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "bytedance/seedance-2.0-fast" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480p", "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "480p", "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "type": "string" }, { "availability": "source_interface", "conditions": "Omitir generate_audio selecciona el precio con audio; false selecciona el precio sin audio. Revisa has_audio en el resultado para saber si se devolvió una pista de audio.", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Estas claves se aplican a cada objeto de fotograma. Omite frame_images para una solicitud de solo texto.", "content": "Arreglo de objetos de fotograma. Cada uno tiene type=image_url, image_url que contiene url y frame_type=first_frame o last_frame. Cada función puede aparecer como máximo una vez. Usa URL HTTPS públicas.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "conditions": "Omite frame_images para usar el modo de referencias. Usa URL HTTPS públicas.", "content": "Arreglo de objetos de referencia de imagen o audio. Establece type en image_url o audio_url y proporciona el objeto URL correspondiente que contiene url. Las referencias de video siguen sin poder cotizarse.", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 9223372036854775807, "minimum": -9223372036854775808, "name": "seed", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "bytedance/seedance-2.0-fast" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "480p", "720p" ] }, "seed": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Request geometry is required for the pre-generation estimate and reserve. Returned geometry and track time describe the generated output; final charge follows the actual billed configuration.", "Video references with *_with_video_input quantity are rejected; image/audio references only where model reference types admit them." ] }, "unsupported": [ "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "seed", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "La tarifa por tokens de video es la referencia principal de precio. Las estimaciones destacadas por segundo son referencias independientes, no un cargo adicional.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Precio por token de video", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "La tarifa por tokens de video es la referencia principal de precio. Las estimaciones destacadas por segundo son referencias independientes, no un cargo adicional.", "dimensions": { "conditions": "entrada: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Precio por token de video", "units": [ { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "Esta estimación no es un cargo adicional ni una tarifa fija por la generación completada.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Costo estimado de generación", "units": [ { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"model\":\"bytedance/seedance-2.0-fast\",\"prompt\":\"A serene mountain landscape at sunset\",\"duration\":4,\"resolution\":\"480p\",\"size\":\"480x480\",\"generate_audio\":false}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image", "audio" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "input: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "bytedance/seedance-2.0-fast", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" }, { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "bytedance/seedance-2.0-fast", "request_model_id": "bytedance/seedance-2.0-fast", "route_label": "Ultra" } ], "name": "ByteDance: Seedance 2.0 Fast", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 0.18144, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 0.18144, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": false, "maker_model_id": "dreamina-seedance-2-0-fast-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": false, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "label": "Ultra", "units": [ { "amount": "0.0000112", "amount_unit": "usd_per_token", "conditions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": false, "maker_model_id": "dreamina-seedance-2-0-fast-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": false, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "key": "base", "label": "base", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "video_token" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": true, "maker_model_id": "dreamina-seedance-2-0-fast-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": true, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "label": "Ultra", "units": [ { "amount": "0.0000066", "amount_unit": "usd_per_token", "conditions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": true, "maker_model_id": "dreamina-seedance-2-0-fast-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": true, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "key": "base", "label": "base", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "video_token" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "basis": "video token", "billing_original_currency": "USD", "billing_original_rate": "0.0000084", "key": "video_tokens", "label": "video token", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" }, { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "basis": "audio=false", "billing_original_currency": "USD", "billing_original_rate": "0.0000084", "key": "video_tokens_without_audio", "label": "video token", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" }, { "amount": "0.004950000", "amount_unit": "usd_per_thousand_tokens", "basis": "video_reference_present Source-only tariff component.", "billing_original_currency": "USD", "billing_original_rate": "0.000004950", "key": "video_tokens_with_video_input", "label": "video token", "native_amount_usd_per_unit": "0.000004950", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" } ] } ], "public_id": "bytedance/seedance-2.0-fast", "short": "ByteDance Seedance 2.0 Fast crea escenas de audio y video a partir de texto y referencias de imagen, video y sonido. Esta edición centrada en velocidad admite transferencia de movimiento y estilo, ediciones de video y extensiones hacia adelante o atrás, con salida documentada de 480p y 720p." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "ByteDance Seedance 2.0 Fast crea escenas de audio y video a partir de texto y referencias de imagen, video y sonido. Esta edición centrada en velocidad admite transferencia de movimiento y estilo, ediciones de video y extensiones hacia adelante o atrás, con salida documentada de 480p y 720p.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_exact_canonical_sha256": "a28fbd260215d3705b0ca860e99f7f08158f148bb297157f1a05d354983cbb64", "raw_model_js_projection_sha256": "9945a8a8eca4025eeaf812479427982faa7374fbfa063127a8ccfcd211718746", "raw_model_json_sha256": "a28fbd260215d3705b0ca860e99f7f08158f148bb297157f1a05d354983cbb64", "renderer_sha256": "50c5984577eac7205687c05e1c36de5d3ba7a0afdff02194efad3a88143581e8" }, "sourceRevision": "5a928cee2e49bdbc240d10bd8943524e49a8305464e53e61408b29e4c3c9f57d" }