{ "aboutHtml": "

Seedance 2.0 Mini es un modelo con nombre propio dentro de la familia audiovisual Seedance 2.0 de ByteDance. Su fabricante documenta conversión de texto a vídeo, de imagen a vídeo con primer fotograma o con primer y último fotograma, generación con referencias multimodales, edición de vídeo y ampliación de vídeo. El sonido puede generarse junto con la imagen. Elija el modo de creación según el material del que ya disponga: un encargo escrito, una imagen inicial fija, dos fotogramas de los extremos o un clip que necesite edición o continuación.

Mini tiene su propio perfil de salida. El fabricante enumera vídeo de 480p y 720p con color de 8 bits, 24 fotogramas por segundo y salida MP4. Sus relaciones de aspecto compatibles son 21:9, 16:9, 4:3, 1:1, 3:4 y 9:16; la duración documentada de generación es de 4–15 segundos. El control de duración del fabricante también permite la selección automática dentro de ese intervalo. Las opciones de 1080p y 4K del modelo completo Seedance 2.0 son independientes; no son ajustes de Mini. La tabla de capacidades de la familia incluye devolver el último fotograma generado, mientras que el modo Draft no es compatible.

Omni reference crea una escena nueva utilizando información seleccionada del material suministrado. Una imagen puede definir el aspecto de un sujeto, la composición o el tratamiento visual. Un vídeo puede establecer una acción, un movimiento de cámara o un efecto; una referencia de audio puede establecer un timbre de voz, una melodía o contenido hablado. Indique al modelo qué debe tomar de cada referencia, en lugar de pedirle que copie todas sus propiedades. Por ejemplo, utilice una fotografía de producto para la forma y el color, un clip breve de movimiento de cámara para el acercamiento y una referencia sonora para la atmósfera.

El flujo de la familia permite hasta nueve imágenes de referencia, tres clips de vídeo y tres clips de audio. Las referencias de vídeo duran 2–15 segundos cada una, sin superar los 15 segundos en total; las de audio utilizan los mismos límites por clip y de duración total. El audio solo y el texto más audio sin referencia visual no son combinaciones de referencia compatibles. La creación solo con texto es un modo independiente compatible. Para una secuencia, proporcione los recursos en el orden previsto y refiérase a ellos de forma coherente como Image 1, Video 1 o Audio 1, siguiendo el orden dentro de cada tipo de medio. No sustituya una referencia numerada por un identificador de recurso en el texto de la instrucción.

Una imagen de primer fotograma define el comienzo de un plano basado en imagen. El modo de primer y último fotograma define ambos extremos. Si esas imágenes exactas de los extremos son importantes, seleccione ese modo específico, en lugar de describir las referencias como inicio y final dentro de una instrucción omni-reference. Lo segundo es un efecto guiado por instrucciones y no equivale a seleccionar estrictamente fotogramas de los extremos. Prepare las imágenes para la composición de salida e indique la acción que conecta las situaciones inicial y final.

La edición de vídeo modifica un clip existente, en lugar de utilizarlo solo como inspiración. Identifique el vídeo que se debe editar, el objeto o la zona que se va a cambiar, el momento y la posición en que aparece y los detalles que deben conservarse. Un encargo útil es: «En Video 1, sustituye la taza por el recipiente mostrado en Image 1; conserva el movimiento de la mano, el encuadre, la iluminación y la disposición de la mesa». Para eliminar algo, nombre el objeto no deseado y los elementos circundantes que deben permanecer. El fabricante aconseja referirse directamente al vídeo objetivo para editarlo o ampliarlo; describirlo como referencia puede comunicar, en cambio, una petición de escena nueva generada.

La ampliación de vídeo añade acontecimientos antes o después de un clip existente. Describa la dirección de la continuación y lo que ocurre después o antes. El flujo documentado también puede conectar dos o tres clips con transiciones generadas; los tres vídeos de entrada juntos siguen ajustándose al límite de referencia de 15 segundos. El tutorial distingue una continuación que incluye principalmente el material de los extremos del clip original de una petición que conserva explícitamente el contenido original. Indique la composición deseada del resultado: solo la continuación o una escena que contenga el clip proporcionado y la nueva acción.

Para dar indicaciones claras, separe la descripción estable de la escena de la secuencia de acontecimientos. Defina cada sujeto con dos o tres rasgos visuales distintivos y una etiqueta coherente. Después describa las acciones, el escenario, la iluminación, el movimiento de cámara, el estilo visual y las restricciones. En un diálogo, asocie cada frase con su hablante y la acción correspondiente. Utilice etiquetas de plano ordenadas, en lugar de tratar las marcas de tiempo exactas como controles fiables: el fabricante señala que la sincronización precisa puede ser inestable. Un encargo de producto por planos podría ser: «Image 1 define el Producto A. Plano 1: acércate lentamente al Producto A sobre la encimera. Plano 2: una mano lo gira hacia la luz. Plano 3: detente sobre la etiqueta frontal. Ambiente suave de habitación; conserva las letras impresas».

Prepare las referencias según las reglas documentadas de entrada de la familia. Los formatos de imagen compatibles incluyen JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC y HEIF; cada imagen debe ocupar menos de 30 MB. La guía especifica ancho y alto de imagen estrictamente entre 300 y 6000 píxeles y relación de aspecto estrictamente entre 0.4 y 2.5. Las referencias de vídeo utilizan MP4 o MOV con vídeo H.264 o H.265 y audio AAC o MP3, ocupan como máximo 200 MB cada una y tienen 24–60 fotogramas por segundo. Su ancho y alto son de 300–6000 píxeles, su relación de aspecto de 0.4–2.5 y su número total de píxeles de 407 696–8 295 044. Las referencias de audio utilizan WAV o MP3 y ocupan como máximo 15 MB cada una. Son especificaciones de preparación de entradas del fabricante, distintas de los controles de carga de una aplicación concreta.

El flujo de retratos del fabricante exige una preparación específica para imágenes o vídeos que contengan rostros humanos reales: la carga directa de referencias no es la vía estándar compatible. Documenta como soluciones independientes las salidas fiables de modelos, los personajes digitales predefinidos y un flujo autorizado de recursos de personas reales. También se deben revisar la correspondencia de voz, la pronunciación y el sonido en los extremos del clip. La guía de instrucciones recomienda describir las características de voz deseadas y mantener el estilo de diálogo próximo a la referencia de audio. Revise el resultado final para comprobar la coherencia del sujeto, las palabras habladas exactas, la sincronización de acciones, las transiciones entre fotogramas y el audio de cierre; ajuste el elemento concreto que se aparte del encargo.

", "aboutText": "Seedance 2.0 Mini es un modelo con nombre propio dentro de la familia audiovisual Seedance 2.0 de ByteDance. Su fabricante documenta conversión de texto a vídeo, de imagen a vídeo con primer fotograma o con primer y último fotograma, generación con referencias multimodales, edición de vídeo y ampliación de vídeo. El sonido puede generarse junto con la imagen. Elija el modo de creación según el material del que ya disponga: un encargo escrito, una imagen inicial fija, dos fotogramas de los extremos o un clip que necesite edición o continuación.\n\nMini tiene su propio perfil de salida. El fabricante enumera vídeo de 480p y 720p con color de 8 bits, 24 fotogramas por segundo y salida MP4. Sus relaciones de aspecto compatibles son 21:9, 16:9, 4:3, 1:1, 3:4 y 9:16; la duración documentada de generación es de 4–15 segundos. El control de duración del fabricante también permite la selección automática dentro de ese intervalo. Las opciones de 1080p y 4K del modelo completo Seedance 2.0 son independientes; no son ajustes de Mini. La tabla de capacidades de la familia incluye devolver el último fotograma generado, mientras que el modo Draft no es compatible.\n\nOmni reference crea una escena nueva utilizando información seleccionada del material suministrado. Una imagen puede definir el aspecto de un sujeto, la composición o el tratamiento visual. Un vídeo puede establecer una acción, un movimiento de cámara o un efecto; una referencia de audio puede establecer un timbre de voz, una melodía o contenido hablado. Indique al modelo qué debe tomar de cada referencia, en lugar de pedirle que copie todas sus propiedades. Por ejemplo, utilice una fotografía de producto para la forma y el color, un clip breve de movimiento de cámara para el acercamiento y una referencia sonora para la atmósfera.\n\nEl flujo de la familia permite hasta nueve imágenes de referencia, tres clips de vídeo y tres clips de audio. Las referencias de vídeo duran 2–15 segundos cada una, sin superar los 15 segundos en total; las de audio utilizan los mismos límites por clip y de duración total. El audio solo y el texto más audio sin referencia visual no son combinaciones de referencia compatibles. La creación solo con texto es un modo independiente compatible. Para una secuencia, proporcione los recursos en el orden previsto y refiérase a ellos de forma coherente como Image 1, Video 1 o Audio 1, siguiendo el orden dentro de cada tipo de medio. No sustituya una referencia numerada por un identificador de recurso en el texto de la instrucción.\n\nUna imagen de primer fotograma define el comienzo de un plano basado en imagen. El modo de primer y último fotograma define ambos extremos. Si esas imágenes exactas de los extremos son importantes, seleccione ese modo específico, en lugar de describir las referencias como inicio y final dentro de una instrucción omni-reference. Lo segundo es un efecto guiado por instrucciones y no equivale a seleccionar estrictamente fotogramas de los extremos. Prepare las imágenes para la composición de salida e indique la acción que conecta las situaciones inicial y final.\n\nLa edición de vídeo modifica un clip existente, en lugar de utilizarlo solo como inspiración. Identifique el vídeo que se debe editar, el objeto o la zona que se va a cambiar, el momento y la posición en que aparece y los detalles que deben conservarse. Un encargo útil es: «En Video 1, sustituye la taza por el recipiente mostrado en Image 1; conserva el movimiento de la mano, el encuadre, la iluminación y la disposición de la mesa». Para eliminar algo, nombre el objeto no deseado y los elementos circundantes que deben permanecer. El fabricante aconseja referirse directamente al vídeo objetivo para editarlo o ampliarlo; describirlo como referencia puede comunicar, en cambio, una petición de escena nueva generada.\n\nLa ampliación de vídeo añade acontecimientos antes o después de un clip existente. Describa la dirección de la continuación y lo que ocurre después o antes. El flujo documentado también puede conectar dos o tres clips con transiciones generadas; los tres vídeos de entrada juntos siguen ajustándose al límite de referencia de 15 segundos. El tutorial distingue una continuación que incluye principalmente el material de los extremos del clip original de una petición que conserva explícitamente el contenido original. Indique la composición deseada del resultado: solo la continuación o una escena que contenga el clip proporcionado y la nueva acción.\n\nPara dar indicaciones claras, separe la descripción estable de la escena de la secuencia de acontecimientos. Defina cada sujeto con dos o tres rasgos visuales distintivos y una etiqueta coherente. Después describa las acciones, el escenario, la iluminación, el movimiento de cámara, el estilo visual y las restricciones. En un diálogo, asocie cada frase con su hablante y la acción correspondiente. Utilice etiquetas de plano ordenadas, en lugar de tratar las marcas de tiempo exactas como controles fiables: el fabricante señala que la sincronización precisa puede ser inestable. Un encargo de producto por planos podría ser: «Image 1 define el Producto A. Plano 1: acércate lentamente al Producto A sobre la encimera. Plano 2: una mano lo gira hacia la luz. Plano 3: detente sobre la etiqueta frontal. Ambiente suave de habitación; conserva las letras impresas».\n\nPrepare las referencias según las reglas documentadas de entrada de la familia. Los formatos de imagen compatibles incluyen JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC y HEIF; cada imagen debe ocupar menos de 30 MB. La guía especifica ancho y alto de imagen estrictamente entre 300 y 6000 píxeles y relación de aspecto estrictamente entre 0.4 y 2.5. Las referencias de vídeo utilizan MP4 o MOV con vídeo H.264 o H.265 y audio AAC o MP3, ocupan como máximo 200 MB cada una y tienen 24–60 fotogramas por segundo. Su ancho y alto son de 300–6000 píxeles, su relación de aspecto de 0.4–2.5 y su número total de píxeles de 407 696–8 295 044. Las referencias de audio utilizan WAV o MP3 y ocupan como máximo 15 MB cada una. Son especificaciones de preparación de entradas del fabricante, distintas de los controles de carga de una aplicación concreta.\n\nEl flujo de retratos del fabricante exige una preparación específica para imágenes o vídeos que contengan rostros humanos reales: la carga directa de referencias no es la vía estándar compatible. Documenta como soluciones independientes las salidas fiables de modelos, los personajes digitales predefinidos y un flujo autorizado de recursos de personas reales. También se deben revisar la correspondencia de voz, la pronunciación y el sonido en los extremos del clip. La guía de instrucciones recomienda describir las características de voz deseadas y mantener el estilo de diálogo próximo a la referencia de audio. Revise el resultado final para comprobar la coherencia del sujeto, las palabras habladas exactas, la sincronización de acciones, las transiciones entre fotogramas y el audio de cierre; ajuste el elemento concreto que se aparte del encargo.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "1547a1aa699c26acd8aec4dbbef6ae856725981cac8e941bcec60b5ada32a0b2", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "es", "methods": [ { "html": "
•

ByteDance: Seedance 2.0 Mini

ByteDance /bytedance/seedance-2.0-mini

Primeros pasos

Seedance 2.0 Mini crea vídeos cortos con sonido generado opcional a partir de texto y referencias de imagen, vídeo y audio. Admite creación de escenas, ediciones de vídeo específicas y continuación, con un perfil de salida documentado de 480p o 720p.

Entradas aceptadas
Texto · Imágenes · Audio
Resultados
Vídeo
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 Mini es un modelo con nombre propio dentro de la familia audiovisual Seedance 2.0 de ByteDance. Su fabricante documenta conversión de texto a vídeo, de imagen a vídeo con primer fotograma o con primer y último fotograma, generación con referencias multimodales, edición de vídeo y ampliación de vídeo. El sonido puede generarse junto con la imagen. Elija el modo de creación según el material del que ya disponga: un encargo escrito, una imagen inicial fija, dos fotogramas de los extremos o un clip que necesite edición o continuación.

Mini tiene su propio perfil de salida. El fabricante enumera vídeo de 480p y 720p con color de 8 bits, 24 fotogramas por segundo y salida MP4. Sus relaciones de aspecto compatibles son 21:9, 16:9, 4:3, 1:1, 3:4 y 9:16; la duración documentada de generación es de 4–15 segundos. El control de duración del fabricante también permite la selección automática dentro de ese intervalo. Las opciones de 1080p y 4K del modelo completo Seedance 2.0 son independientes; no son ajustes de Mini. La tabla de capacidades de la familia incluye devolver el último fotograma generado, mientras que el modo Draft no es compatible.

Omni reference crea una escena nueva utilizando información seleccionada del material suministrado. Una imagen puede definir el aspecto de un sujeto, la composición o el tratamiento visual. Un vídeo puede establecer una acción, un movimiento de cámara o un efecto; una referencia de audio puede establecer un timbre de voz, una melodía o contenido hablado. Indique al modelo qué debe tomar de cada referencia, en lugar de pedirle que copie todas sus propiedades. Por ejemplo, utilice una fotografía de producto para la forma y el color, un clip breve de movimiento de cámara para el acercamiento y una referencia sonora para la atmósfera.

El flujo de la familia permite hasta nueve imágenes de referencia, tres clips de vídeo y tres clips de audio. Las referencias de vídeo duran 2–15 segundos cada una, sin superar los 15 segundos en total; las de audio utilizan los mismos límites por clip y de duración total. El audio solo y el texto más audio sin referencia visual no son combinaciones de referencia compatibles. La creación solo con texto es un modo independiente compatible. Para una secuencia, proporcione los recursos en el orden previsto y refiérase a ellos de forma coherente como Image 1, Video 1 o Audio 1, siguiendo el orden dentro de cada tipo de medio. No sustituya una referencia numerada por un identificador de recurso en el texto de la instrucción.

Una imagen de primer fotograma define el comienzo de un plano basado en imagen. El modo de primer y último fotograma define ambos extremos. Si esas imágenes exactas de los extremos son importantes, seleccione ese modo específico, en lugar de describir las referencias como inicio y final dentro de una instrucción omni-reference. Lo segundo es un efecto guiado por instrucciones y no equivale a seleccionar estrictamente fotogramas de los extremos. Prepare las imágenes para la composición de salida e indique la acción que conecta las situaciones inicial y final.

La edición de vídeo modifica un clip existente, en lugar de utilizarlo solo como inspiración. Identifique el vídeo que se debe editar, el objeto o la zona que se va a cambiar, el momento y la posición en que aparece y los detalles que deben conservarse. Un encargo útil es: «En Video 1, sustituye la taza por el recipiente mostrado en Image 1; conserva el movimiento de la mano, el encuadre, la iluminación y la disposición de la mesa». Para eliminar algo, nombre el objeto no deseado y los elementos circundantes que deben permanecer. El fabricante aconseja referirse directamente al vídeo objetivo para editarlo o ampliarlo; describirlo como referencia puede comunicar, en cambio, una petición de escena nueva generada.

La ampliación de vídeo añade acontecimientos antes o después de un clip existente. Describa la dirección de la continuación y lo que ocurre después o antes. El flujo documentado también puede conectar dos o tres clips con transiciones generadas; los tres vídeos de entrada juntos siguen ajustándose al límite de referencia de 15 segundos. El tutorial distingue una continuación que incluye principalmente el material de los extremos del clip original de una petición que conserva explícitamente el contenido original. Indique la composición deseada del resultado: solo la continuación o una escena que contenga el clip proporcionado y la nueva acción.

Para dar indicaciones claras, separe la descripción estable de la escena de la secuencia de acontecimientos. Defina cada sujeto con dos o tres rasgos visuales distintivos y una etiqueta coherente. Después describa las acciones, el escenario, la iluminación, el movimiento de cámara, el estilo visual y las restricciones. En un diálogo, asocie cada frase con su hablante y la acción correspondiente. Utilice etiquetas de plano ordenadas, en lugar de tratar las marcas de tiempo exactas como controles fiables: el fabricante señala que la sincronización precisa puede ser inestable. Un encargo de producto por planos podría ser: «Image 1 define el Producto A. Plano 1: acércate lentamente al Producto A sobre la encimera. Plano 2: una mano lo gira hacia la luz. Plano 3: detente sobre la etiqueta frontal. Ambiente suave de habitación; conserva las letras impresas».

Prepare las referencias según las reglas documentadas de entrada de la familia. Los formatos de imagen compatibles incluyen JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC y HEIF; cada imagen debe ocupar menos de 30 MB. La guía especifica ancho y alto de imagen estrictamente entre 300 y 6000 píxeles y relación de aspecto estrictamente entre 0.4 y 2.5. Las referencias de vídeo utilizan MP4 o MOV con vídeo H.264 o H.265 y audio AAC o MP3, ocupan como máximo 200 MB cada una y tienen 24–60 fotogramas por segundo. Su ancho y alto son de 300–6000 píxeles, su relación de aspecto de 0.4–2.5 y su número total de píxeles de 407 696–8 295 044. Las referencias de audio utilizan WAV o MP3 y ocupan como máximo 15 MB cada una. Son especificaciones de preparación de entradas del fabricante, distintas de los controles de carga de una aplicación concreta.

El flujo de retratos del fabricante exige una preparación específica para imágenes o vídeos que contengan rostros humanos reales: la carga directa de referencias no es la vía estándar compatible. Documenta como soluciones independientes las salidas fiables de modelos, los personajes digitales predefinidos y un flujo autorizado de recursos de personas reales. También se deben revisar la correspondencia de voz, la pronunciación y el sonido en los extremos del clip. La guía de instrucciones recomienda describir las características de voz deseadas y mantener el estilo de diálogo próximo a la referencia de audio. Revise el resultado final para comprobar la coherencia del sujeto, las palabras habladas exactas, la sincronización de acciones, las transiciones entre fotogramas y el audio de cierre; ajuste el elemento concreto que se aparte del encargo.

Disponible en Ailoot · entradas y métodos

Ailoot Ultra · Vídeo POST /v1/videos
Tipos de entrada
text, image, audio
Tipos de 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-mini
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. Comprueba has_audio en el resultado para saber si se ha devuelto 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: Lista de objetos de fotograma. Cada uno contiene type=image_url, image_url con url y frame_type=first_frame o last_frame. Cada función aparece 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 que solo contenga texto.
Predeterminado—
Campoinput_referencesTipoarrayRequisitoOpcionalValores y límites
Contenido de entrada: Lista 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 vídeo siguen sin poder valorarse.
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 vídeo · 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 los enumerados, o una resolución y una relación de aspecto que se correspondan con las dimensiones enumeradas.

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

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

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

frame_images es una lista 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 unas dimensiones compatibles. No añadas referencias de vídeo.

Claves exactas: type, image_url, frame_type

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

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 una lista. 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 vídeo no pueden valorarse.

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

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

Planes

Cómo se calcula el cargo definitivo

Las tarifas mostradas estiman el coste antes de la generación. El cargo final se calcula a partir del coste registrado para la generación original. La duración medida del resultado y las cantidades previstas no constituyen 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 rápido
Sin especificar Cuando se selecciona el modo rápido
Modo flex
Sin especificar Cuando se selecciona el modo flex
Esfuerzo máximo de razonamiento
Sin especificar Cuando el esfuerzo máximo de razonamiento utiliza el ajuste predeterminado (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 vídeoTabla de tarifas—Cantidad prevista—Unidad de facturaciónpor 1K tokens de vídeoCondiciones de facturaciónNo se declara ninguna condición adicional en esta clave de precios.Cargo
Salida · Precio por token de vídeo · Estimación solo para comparar $0.007 por 1K tokens de vídeo

La tarifa por token de vídeo es la referencia principal de precios. Las estimaciones destacadas por segundo son referencias separadas, no un cargo adicional.

ConfiguraciónPrecio por token de vídeoTabla de tarifas—Cantidad prevista—Unidad de facturaciónpor 1K tokens de vídeoCondiciones de facturaciónentrada: with_video_inputCargo
reference · Precio por token de vídeo · Estimación solo para comparar $0.0042 por 1K tokens de vídeo

La tarifa por token de vídeo es la referencia principal de precios. Las estimaciones destacadas por segundo son referencias separadas, no un cargo adicional.

ConfiguraciónPrecio por token de vídeoTabla de tarifas—Cantidad prevista—Unidad de facturaciónpor 1K tokens de vídeoCondiciones de facturaciónsonido: without_audioCargo
Salida · Precio por token de vídeo · Estimación solo para comparar $0.007 por 1K tokens de vídeo

La tarifa por token de vídeo es la referencia principal de precios. Las estimaciones destacadas por segundo son referencias separadas, no un cargo adicional.

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

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

Ailoot reserva un importe 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 estimaciones de coste ni los cargos. Los cargos aplicados usan las tarifas del método Ailoot seleccionado.

Referencias de precios de configuraciones de vídeo

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 vídeoCondiciones de facturaciónNo se declara ninguna condición adicional en esta clave de precios.Cargo
Salida · Precio por token de vídeo $0.007 por 1K tokens de vídeo

La tarifa por token de vídeo es la referencia principal de precios. Las estimaciones destacadas por segundo son referencias separadas, no un cargo adicional.

ConfiguraciónPrecio por token de vídeoCondiciones de facturaciónsonido: without_audioCargo
Salida · Precio por token de vídeo $0.007 por 1K tokens de vídeo

La tarifa por token de vídeo es la referencia principal de precios. Las estimaciones destacadas por segundo son referencias separadas, no un cargo adicional.

ConfiguraciónPrecio por token de vídeoCondiciones de facturaciónentrada: with_video_inputCargo
reference · Precio por token de vídeo $0.0042 por 1K tokens de vídeo

La tarifa por token de vídeo es la referencia principal de precios. Las estimaciones destacadas por segundo son referencias separadas, no un cargo adicional.

Solicitudes de ejemplo

Ailoot Ultra · Vídeo

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-mini","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 · Vídeo

URL firmadas de contenido bajo tu titularidad

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 vídeos completados o archivos recibidos; descarga cada URL de archivo que se haya devuelto.

Conserva todos los resultados reales bajo tu titularidad y los metadatos medidos que se devuelvan.

Si es necesario revisar la respuesta original

503 result_pending_check + originalid + X-Should-Retry:false; no repitas nunca la operación original

Campos de respuesta
CampoTipoSignificado
CampoindexTipointegerSignificadoPosición de este vídeo en la lista de resultados, empezando por cero.
Campocontent_urlTipostringSignificadoURL HTTPS firmada de descarga de este vídeo completado.
Camposha256Tipostring | nullSignificadoHuella SHA-256 de los bytes del vídeo original; null si no está disponible.
Camposize_bytesTipointeger | nullSignificadoTamaño del archivo de vídeo original en bytes; null si no está disponible.
Campoduration_msTipointeger | nullSignificadoDuración medida del vídeo en milisegundos; null si no está disponible.
CampowidthTipointeger | nullSignificadoAnchura del vídeo en píxeles; null si no está disponible.
CampoheightTipointeger | nullSignificadoAltura del vídeo en píxeles; null si no está disponible.
Campovideo_codecTipostring | nullSignificadoIdentificador del códec de vídeo; null si no se ha registrado.
Campohas_audioTipoboolean | nullSignificadoIndica si el vídeo contiene una pista de audio; null si no se ha medido.
Campoaudio_codecTipostring | nullSignificadoIdentificador del códec de audio; null cuando no se ha registrado ninguno.
Errores y siguientes pasos
RespuestaCondiciónSiguiente paso
Respuesta404 · not_found_errorCondiciónEl acceso al vídeo no está disponible o no se ha encontrado este ID de vídeo.Siguiente pasoComprueba el acceso al vídeo. Para un vídeo existente, usa su ID público original y la misma clave API.
Respuesta401 · authentication_errorCondiciónLa clave API no corresponde a la cuenta autenticada.Siguiente pasoComprueba tu clave API y el acceso de tu cuenta antes de enviar la solicitud.
Respuesta400 · invalid_request_errorCondiciónNo se ha podido 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 calcular el precio de la configuración de vídeo seleccionada.Siguiente pasoElige una configuración de vídeo compatible y completa sus opciones obligatorias antes de enviar una solicitud corregida.
Respuesta422 · invalid_request_errorCondiciónUna entrada de vídeo o la tarea original de continuación no es válida.Siguiente pasoUsa entradas HTTPS válidas. Para continuar, usa el ID público de tu vídeo original completado con la misma clave API.
Respuesta402 · billing_errorCondiciónEl saldo disponible o los límites no permiten efectuar una reserva.Siguiente pasoComprueba tu saldo disponible y tus límites antes de enviar una nueva solicitud.
Respuesta503 · server_errorCondiciónLa verificación del vídeo, 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 vídeo, comprueba esa tarea original en lugar de crear otra generación.
Respuesta503 · result_pending_checkCondiciónEs necesario comprobar el resultado del vídeo original y el cargo.Siguiente pasoConserva el ID de vídeo devuelto y comprueba esa tarea. No envíes una solicitud de generación sustitutiva mientras se esté comprobando.
Respuesta503 · owned_result_unavailableCondiciónLa descarga del vídeo existente no está disponible temporalmente.Siguiente pasoComprueba más tarde la misma tarea de vídeo y descarga su resultado existente. Una nueva generación crea una operación independiente.
Respuesta409 · video_not_readyCondiciónEl contenido del vídeo no se ha publicado.Siguiente pasoComprueba el estado de la tarea original. Descarga cuando indique completed; si indica failed, sigue su aviso de comprobación del cargo.

Alias

Alias del modelo

Ailoot Ultra bytedance/seedance-2.0-mini

Alias de rutas de métodos

Usa las rutas de método indicadas arriba.

ID de modelo relacionados

bytedance/seedance-2.0-mini

", "method_identity": { "effective_request_model_id": "bytedance/seedance-2.0-mini", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "bytedance/seedance-2.0-mini", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|bytedance%2Fseedance-2.0-mini", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Las tarifas mostradas estiman el coste antes de la generación. El cargo final se calcula a partir del coste registrado para la generación original. La duración medida del resultado y las cantidades previstas no constituyen 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 todos los resultados reales bajo tu titularidad y los metadatos medidos que se devuelvan.", "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 vídeo no está disponible o no se ha encontrado este ID de vídeo.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Comprueba el acceso al vídeo. Para un vídeo existente, usa su ID público original y la misma clave API.", "type": "not_found_error" }, { "condition": "La clave API no corresponde a la cuenta autenticada.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Comprueba tu clave API y el acceso de tu cuenta antes de enviar la solicitud.", "type": "authentication_error" }, { "condition": "No se ha podido 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 calcular el precio de la configuración de vídeo seleccionada.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Elige una configuración de vídeo compatible y completa sus opciones obligatorias antes de enviar una solicitud corregida.", "type": "price_unavailable" }, { "condition": "Una entrada de vídeo 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 continuar, usa el ID público de tu vídeo original completado con la misma clave API.", "type": "invalid_request_error" }, { "condition": "El saldo disponible o los límites no permiten efectuar una reserva.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Comprueba tu saldo disponible y tus límites antes de enviar una nueva solicitud.", "type": "billing_error" }, { "condition": "La verificación del vídeo, 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 vídeo, comprueba esa tarea original en lugar de crear otra generación.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Es necesario comprobar el resultado del vídeo original y el cargo.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Conserva el ID de vídeo devuelto y comprueba esa tarea. No envíes una solicitud de generación sustitutiva mientras se esté comprobando.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "La descarga del vídeo existente no está disponible temporalmente.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Comprueba más tarde la misma tarea de vídeo y descarga su resultado existente. Una nueva generación crea una operación independiente.", "type": "server_error" }, { "condition": "El contenido del vídeo no se ha publicado.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Comprueba el estado de la tarea original. Descarga cuando indique completed; si indica failed, sigue su aviso de comprobació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 + originalid + X-Should-Retry:false; no repitas nunca la operación original" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "bytedance/seedance-2.0-mini" ], "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 los enumerados, o una resolución y una relación de aspecto que se correspondan con 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-mini" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images es una lista 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 unas dimensiones compatibles. No añadas referencias de vídeo.", "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-mini" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references es una lista. 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 vídeo no pueden valorarse.", "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 vídeo en la lista de resultados, empezando por 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 vídeo 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": "Huella SHA-256 de los bytes del vídeo 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 vídeo 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 vídeo 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": "Anchura del vídeo 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": "Altura del vídeo 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 vídeo; null si no se ha registrado.", "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 vídeo contiene una pista de audio; null si no se ha medido.", "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 ha registrado ninguno.", "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 bajo tu titularidad", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "bytedance/seedance-2.0-mini" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "bytedance/seedance-2.0-mini" }, "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. Comprueba has_audio en el resultado para saber si se ha devuelto 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 que solo contenga texto.", "content": "Lista de objetos de fotograma. Cada uno contiene type=image_url, image_url con url y frame_type=first_frame o last_frame. Cada función aparece 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": "Lista 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 vídeo siguen sin poder valorarse.", "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-mini" }, "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 token de vídeo es la referencia principal de precios. Las estimaciones destacadas por segundo son referencias separadas, 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 vídeo", "units": [ { "amount": "0.007000", "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.000007", "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 token de vídeo es la referencia principal de precios. Las estimaciones destacadas por segundo son referencias separadas, no un cargo adicional.", "dimensions": { "conditions": "entrada: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Precio por token de vídeo", "units": [ { "amount": "0.0042000", "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.0000042", "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.007000", "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.000007", "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 para la generación completada.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Coste estimado de generación", "units": [ { "amount": "0.1512", "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.1512", "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-mini\",\"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.007000", "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.000007", "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.0042000", "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.0000042", "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.007000", "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.000007", "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.1512", "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.1512", "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-mini", "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.007000", "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.000007", "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.0042000", "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.0000042", "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.007000", "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.000007", "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.1512", "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.1512", "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-mini", "nativeProvenance": { "input_facts_canonical_sha256": "7b6d91bb29d0626a09bab5a6c5888ab34563f2942beaf2165b0740499439a9b7", "input_html_sha256": "7ee7864c147dd31e87e22ee4658d3c1d5022c4ace8da5e41ffcef6d35aa92e1b", "private_audit_sha256": "5806c74a4820f4957ebfe5bbb565cab58c5b9e960fd8c0dcad71aba5a1915ade", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/es/bytedance-seedance-2-0-mini/", "description": "Seedance 2.0 Mini crea vídeos cortos con sonido generado opcional a partir de texto y referencias de imagen, vídeo y audio. Admite creación de escenas, ediciones de vídeo específicas y continuación, con un perfil de salida documentado de 480p o 720p.", "locale": "es", "md_url": "https://ailoot.ai/models/es/bytedance-seedance-2-0-mini/index.md", "title": "ByteDance: Seedance 2.0 Mini — Ailoot", "url": "https://ailoot.ai/models/es/bytedance-seedance-2-0-mini/" }, "rawModel": { "about": "Seedance 2.0 Mini es un modelo con nombre propio dentro de la familia audiovisual Seedance 2.0 de ByteDance. Su fabricante documenta conversión de texto a vídeo, de imagen a vídeo con primer fotograma o con primer y último fotograma, generación con referencias multimodales, edición de vídeo y ampliación de vídeo. El sonido puede generarse junto con la imagen. Elija el modo de creación según el material del que ya disponga: un encargo escrito, una imagen inicial fija, dos fotogramas de los extremos o un clip que necesite edición o continuación.\n\nMini tiene su propio perfil de salida. El fabricante enumera vídeo de 480p y 720p con color de 8 bits, 24 fotogramas por segundo y salida MP4. Sus relaciones de aspecto compatibles son 21:9, 16:9, 4:3, 1:1, 3:4 y 9:16; la duración documentada de generación es de 4–15 segundos. El control de duración del fabricante también permite la selección automática dentro de ese intervalo. Las opciones de 1080p y 4K del modelo completo Seedance 2.0 son independientes; no son ajustes de Mini. La tabla de capacidades de la familia incluye devolver el último fotograma generado, mientras que el modo Draft no es compatible.\n\nOmni reference crea una escena nueva utilizando información seleccionada del material suministrado. Una imagen puede definir el aspecto de un sujeto, la composición o el tratamiento visual. Un vídeo puede establecer una acción, un movimiento de cámara o un efecto; una referencia de audio puede establecer un timbre de voz, una melodía o contenido hablado. Indique al modelo qué debe tomar de cada referencia, en lugar de pedirle que copie todas sus propiedades. Por ejemplo, utilice una fotografía de producto para la forma y el color, un clip breve de movimiento de cámara para el acercamiento y una referencia sonora para la atmósfera.\n\nEl flujo de la familia permite hasta nueve imágenes de referencia, tres clips de vídeo y tres clips de audio. Las referencias de vídeo duran 2–15 segundos cada una, sin superar los 15 segundos en total; las de audio utilizan los mismos límites por clip y de duración total. El audio solo y el texto más audio sin referencia visual no son combinaciones de referencia compatibles. La creación solo con texto es un modo independiente compatible. Para una secuencia, proporcione los recursos en el orden previsto y refiérase a ellos de forma coherente como Image 1, Video 1 o Audio 1, siguiendo el orden dentro de cada tipo de medio. No sustituya una referencia numerada por un identificador de recurso en el texto de la instrucción.\n\nUna imagen de primer fotograma define el comienzo de un plano basado en imagen. El modo de primer y último fotograma define ambos extremos. Si esas imágenes exactas de los extremos son importantes, seleccione ese modo específico, en lugar de describir las referencias como inicio y final dentro de una instrucción omni-reference. Lo segundo es un efecto guiado por instrucciones y no equivale a seleccionar estrictamente fotogramas de los extremos. Prepare las imágenes para la composición de salida e indique la acción que conecta las situaciones inicial y final.\n\nLa edición de vídeo modifica un clip existente, en lugar de utilizarlo solo como inspiración. Identifique el vídeo que se debe editar, el objeto o la zona que se va a cambiar, el momento y la posición en que aparece y los detalles que deben conservarse. Un encargo útil es: «En Video 1, sustituye la taza por el recipiente mostrado en Image 1; conserva el movimiento de la mano, el encuadre, la iluminación y la disposición de la mesa». Para eliminar algo, nombre el objeto no deseado y los elementos circundantes que deben permanecer. El fabricante aconseja referirse directamente al vídeo objetivo para editarlo o ampliarlo; describirlo como referencia puede comunicar, en cambio, una petición de escena nueva generada.\n\nLa ampliación de vídeo añade acontecimientos antes o después de un clip existente. Describa la dirección de la continuación y lo que ocurre después o antes. El flujo documentado también puede conectar dos o tres clips con transiciones generadas; los tres vídeos de entrada juntos siguen ajustándose al límite de referencia de 15 segundos. El tutorial distingue una continuación que incluye principalmente el material de los extremos del clip original de una petición que conserva explícitamente el contenido original. Indique la composición deseada del resultado: solo la continuación o una escena que contenga el clip proporcionado y la nueva acción.\n\nPara dar indicaciones claras, separe la descripción estable de la escena de la secuencia de acontecimientos. Defina cada sujeto con dos o tres rasgos visuales distintivos y una etiqueta coherente. Después describa las acciones, el escenario, la iluminación, el movimiento de cámara, el estilo visual y las restricciones. En un diálogo, asocie cada frase con su hablante y la acción correspondiente. Utilice etiquetas de plano ordenadas, en lugar de tratar las marcas de tiempo exactas como controles fiables: el fabricante señala que la sincronización precisa puede ser inestable. Un encargo de producto por planos podría ser: «Image 1 define el Producto A. Plano 1: acércate lentamente al Producto A sobre la encimera. Plano 2: una mano lo gira hacia la luz. Plano 3: detente sobre la etiqueta frontal. Ambiente suave de habitación; conserva las letras impresas».\n\nPrepare las referencias según las reglas documentadas de entrada de la familia. Los formatos de imagen compatibles incluyen JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC y HEIF; cada imagen debe ocupar menos de 30 MB. La guía especifica ancho y alto de imagen estrictamente entre 300 y 6000 píxeles y relación de aspecto estrictamente entre 0.4 y 2.5. Las referencias de vídeo utilizan MP4 o MOV con vídeo H.264 o H.265 y audio AAC o MP3, ocupan como máximo 200 MB cada una y tienen 24–60 fotogramas por segundo. Su ancho y alto son de 300–6000 píxeles, su relación de aspecto de 0.4–2.5 y su número total de píxeles de 407 696–8 295 044. Las referencias de audio utilizan WAV o MP3 y ocupan como máximo 15 MB cada una. Son especificaciones de preparación de entradas del fabricante, distintas de los controles de carga de una aplicación concreta.\n\nEl flujo de retratos del fabricante exige una preparación específica para imágenes o vídeos que contengan rostros humanos reales: la carga directa de referencias no es la vía estándar compatible. Documenta como soluciones independientes las salidas fiables de modelos, los personajes digitales predefinidos y un flujo autorizado de recursos de personas reales. También se deben revisar la correspondencia de voz, la pronunciación y el sonido en los extremos del clip. La guía de instrucciones recomienda describir las características de voz deseadas y mantener el estilo de diálogo próximo a la referencia de audio. Revise el resultado final para comprobar la coherencia del sujeto, las palabras habladas exactas, la sincronización de acciones, las transiciones entre fotogramas y el audio de cierre; ajuste el elemento concreto que se aparte del encargo.", "alias_of": null, "aliases": [], "author": "ByteDance", "available": null, "canonical_model": "bytedance/seedance-2.0-mini", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image", "video", "audio" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.1512", "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.1512", "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": "0b52dda4bb8d8eb2776e0f56", "label": "Referencias de precios de configuraciones de vídeo", "profiles": [ { "basis": "La tarifa por token de vídeo es la referencia principal de precios. Las estimaciones destacadas por segundo son referencias separadas, no un cargo adicional.", "dimensions": { "conditions": "No se declara ninguna condición adicional en esta clave de precios." }, "label": "Precio por token de vídeo", "units": [ { "amount": "0.007", "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 token de vídeo es la referencia principal de precios. Las estimaciones destacadas por segundo son referencias separadas, no un cargo adicional.", "dimensions": { "conditions": "sonido: without_audio" }, "label": "Precio por token de vídeo", "units": [ { "amount": "0.007", "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 token de vídeo es la referencia principal de precios. Las estimaciones destacadas por segundo son referencias separadas, no un cargo adicional.", "dimensions": { "conditions": "entrada: with_video_input" }, "label": "Precio por token de vídeo", "units": [ { "amount": "0.0042", "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-mini", "input": [ "text", "image", "audio" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Las tarifas mostradas estiman el coste antes de la generación. El cargo final se calcula a partir del coste registrado para la generación original. La duración medida del resultado y las cantidades previstas no constituyen 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 todos los resultados reales bajo tu titularidad y los metadatos medidos que se devuelvan.", "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 vídeo no está disponible o no se ha encontrado este ID de vídeo.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Comprueba el acceso al vídeo. Para un vídeo existente, usa su ID público original y la misma clave API.", "type": "not_found_error" }, { "condition": "La clave API no corresponde a la cuenta autenticada.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Comprueba tu clave API y el acceso de tu cuenta antes de enviar la solicitud.", "type": "authentication_error" }, { "condition": "No se ha podido 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 calcular el precio de la configuración de vídeo seleccionada.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Elige una configuración de vídeo compatible y completa sus opciones obligatorias antes de enviar una solicitud corregida.", "type": "price_unavailable" }, { "condition": "Una entrada de vídeo 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 continuar, usa el ID público de tu vídeo original completado con la misma clave API.", "type": "invalid_request_error" }, { "condition": "El saldo disponible o los límites no permiten efectuar una reserva.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Comprueba tu saldo disponible y tus límites antes de enviar una nueva solicitud.", "type": "billing_error" }, { "condition": "La verificación del vídeo, 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 vídeo, comprueba esa tarea original en lugar de crear otra generación.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Es necesario comprobar el resultado del vídeo original y el cargo.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Conserva el ID de vídeo devuelto y comprueba esa tarea. No envíes una solicitud de generación sustitutiva mientras se esté comprobando.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "La descarga del vídeo existente no está disponible temporalmente.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Comprueba más tarde la misma tarea de vídeo y descarga su resultado existente. Una nueva generación crea una operación independiente.", "type": "server_error" }, { "condition": "El contenido del vídeo no se ha publicado.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Comprueba el estado de la tarea original. Descarga cuando indique completed; si indica failed, sigue su aviso de comprobació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 + originalid + X-Should-Retry:false; no repitas nunca la operación original" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "bytedance/seedance-2.0-mini" ], "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 los enumerados, o una resolución y una relación de aspecto que se correspondan con 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-mini" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images es una lista 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 unas dimensiones compatibles. No añadas referencias de vídeo.", "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-mini" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references es una lista. 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 vídeo no pueden valorarse.", "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 vídeo en la lista de resultados, empezando por 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 vídeo 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": "Huella SHA-256 de los bytes del vídeo 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 vídeo 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 vídeo 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": "Anchura del vídeo 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": "Altura del vídeo 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 vídeo; null si no se ha registrado.", "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 vídeo contiene una pista de audio; null si no se ha medido.", "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 ha registrado ninguno.", "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 bajo tu titularidad", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "bytedance/seedance-2.0-mini" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "bytedance/seedance-2.0-mini" }, "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. Comprueba has_audio en el resultado para saber si se ha devuelto 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 que solo contenga texto.", "content": "Lista de objetos de fotograma. Cada uno contiene type=image_url, image_url con url y frame_type=first_frame o last_frame. Cada función aparece 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": "Lista 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 vídeo siguen sin poder valorarse.", "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-mini" }, "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 token de vídeo es la referencia principal de precios. Las estimaciones destacadas por segundo son referencias separadas, 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 vídeo", "units": [ { "amount": "0.007000", "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.000007", "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 token de vídeo es la referencia principal de precios. Las estimaciones destacadas por segundo son referencias separadas, no un cargo adicional.", "dimensions": { "conditions": "entrada: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Precio por token de vídeo", "units": [ { "amount": "0.0042000", "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.0000042", "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.007000", "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.000007", "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 para la generación completada.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Coste estimado de generación", "units": [ { "amount": "0.1512", "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.1512", "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-mini\",\"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.007000", "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.000007", "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.0042000", "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.0000042", "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.007000", "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.000007", "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.1512", "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.1512", "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-mini", "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.007000", "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.000007", "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.0042000", "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.0000042", "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.007000", "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.000007", "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.1512", "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.1512", "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-mini", "request_model_id": "bytedance/seedance-2.0-mini", "route_label": "Ultra" } ], "name": "ByteDance: Seedance 2.0 Mini", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 0.1512, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 0.1512, "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-mini-260615", "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.0000070", "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-mini-260615", "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-mini-260615", "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.0000042", "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-mini-260615", "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.0070000", "amount_unit": "usd_per_thousand_tokens", "basis": "video token", "billing_original_currency": "USD", "billing_original_rate": "0.0000070", "key": "video_tokens", "label": "video token", "native_amount_usd_per_unit": "0.0000070", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" }, { "amount": "0.0070000", "amount_unit": "usd_per_thousand_tokens", "basis": "audio=false", "billing_original_currency": "USD", "billing_original_rate": "0.0000070", "key": "video_tokens_without_audio", "label": "video token", "native_amount_usd_per_unit": "0.0000070", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" }, { "amount": "0.0042000", "amount_unit": "usd_per_thousand_tokens", "basis": "video_reference_present Source-only tariff component.", "billing_original_currency": "USD", "billing_original_rate": "0.0000042", "key": "video_tokens_with_video_input", "label": "video token", "native_amount_usd_per_unit": "0.0000042", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" } ] } ], "public_id": "bytedance/seedance-2.0-mini", "short": "Seedance 2.0 Mini crea vídeos cortos con sonido generado opcional a partir de texto y referencias de imagen, vídeo y audio. Admite creación de escenas, ediciones de vídeo específicas y continuación, con un perfil de salida documentado de 480p o 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": "Seedance 2.0 Mini crea vídeos cortos con sonido generado opcional a partir de texto y referencias de imagen, vídeo y audio. Admite creación de escenas, ediciones de vídeo específicas y continuación, con un perfil de salida documentado de 480p o 720p.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_exact_canonical_sha256": "2f62b3ea76108fbcb58001f72e2592f520548db84b916b461646255ae99db712", "raw_model_js_projection_sha256": "1b750681d2c307e3e5d9125a9007a8d210919f4449461116b2d862e20275fc66", "raw_model_json_sha256": "2f62b3ea76108fbcb58001f72e2592f520548db84b916b461646255ae99db712", "renderer_sha256": "b6d488b4bdee68568e5b17d2d4871b2ba1885e1032091b635a7a58ad2ca224e7" }, "sourceRevision": "855c3bb41ca474511128d8509060b712a4a517d2fad104a7013f7c7d7dbc7b5c" }