Grok Imagine Video 1.5 Lite es la edición simplificada de generación de la familia de vídeo Grok Imagine. El fabricante la recomienda para trabajos sencillos de texto a vídeo e imagen a vídeo. Una escena escrita puede convertirse en un clip corto, o una imagen fija proporcionada puede servir como fotograma inicial de un plano animado. La salida incluye audio generado y esta edición admite voz con sincronización labial. Entre los entregables útiles están un breve movimiento de producto, un plano de situación atmosférico o un momento sencillo de un personaje que habla.
Para texto a vídeo, describa lo que se ve, lo que ocurre durante el plano y cómo debe observarlo la cámara. Incluya iluminación, ritmo y sonido pertinente. El fabricante explica que Lite primero genera una imagen a partir de la instrucción y después la anima; esa imagen intermedia no se devuelve como recurso independiente. Como preparación práctica, asigne al clip corto un acontecimiento claro y espacio suficiente para que se desarrolle. Un entorno exterior amplio, un detalle cercano de producto y un retrato hablado requieren indicaciones diferentes de composición y movimiento.
Por ejemplo, un encargo original podría pedir un acercamiento lento a una taza de cerámica sobre una tranquila mesa de desayuno mientras asciende vapor, con luz suave de mañana y ambiente discreto de habitación. Lo importante al revisar el resultado es si la taza sigue siendo reconocible, el vapor se mueve de forma natural y la cámara sigue la dirección prevista. Mantenga sencillo el movimiento de ese ejemplo al evaluar el plano. Si un personaje habla, incluya la frase prevista y una descripción concisa de la interpretación; después compruebe las palabras y el movimiento visible de la boca en el resultado.
Para imagen a vídeo, la imagen establece el primer fotograma y la instrucción describe lo que ocurre después. Elija una imagen inicial con el sujeto, el encuadre y los detalles visuales previstos ya presentes. Dé instrucciones de movimiento que encajen con la composición existente, como un pequeño giro de cabeza, un movimiento suave de cámara o viento que afecte a la tela. La salida sigue la relación de aspecto de la imagen; el ajuste independiente de relación de aspecto se ignora en este modo. Prepare de antemano un recorte vertical cuando el clip final necesite ese encuadre.
La duración documentada de salida es de 1–15 segundos, con ocho segundos como valor predeterminado. Texto a vídeo ofrece composiciones cuadradas, horizontales, verticales y más anchas, incluidas 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 y 5:2. Decida cómo se utilizará el plano antes de seleccionar el encuadre. Un clip vertical para redes puede necesitar espacio para añadir subtítulos después, mientras que un inserto horizontal puede necesitar margen alrededor del sujeto para que quien edite pueda cortar con comodidad. Ajuste la acción solicitada a la duración del clip, en lugar de comprimir una secuencia larga en un plano breve.
Lite ofrece salida de 480p y 720p, además de una opción de 1080p obtenida ampliando 720p. Esta distinción importa al planificar material sensible al detalle: un fotograma de salida mayor no significa que esta edición genere la escena de forma nativa a 1080p. Compruebe las letras pequeñas, los bordes de producto y los rostros al tamaño de visualización previsto. Los vídeos generados incluyen audio de forma predeterminada y la configuración de generación del fabricante también permite un resultado silencioso. Especifique la intención sonora con tanto cuidado como la acción visible cuando el clip vaya a utilizarse con su pista generada.
La generación es asíncrona en la interfaz documentada del fabricante. Un identificador de solicitud permite seguir el trabajo mientras está pendiente; una respuesta completada proporciona la ubicación del vídeo y su duración. El ejemplo completado de la guía apunta a un clip MP4 y explica que las ubicaciones de salida son temporales. Conserve el resultado completado al preparar una edición, junto con la instrucción, la imagen de origen y los ajustes elegidos. Una tarea enviada sigue siendo una fase de procesamiento; el resultado útil de producción es el clip reproducible con la imagen y el sonido requeridos.
La elección de edición depende de los controles necesarios para el plano. La versión completa Grok Imagine Video 1.5 añade referencias de varias imágenes, referencias de voz seleccionadas, primeros o últimos fotogramas exactos y fotogramas intermedios fijados, y genera texto o imagen a vídeo a 1080p nativos. Lite se concentra en una instrucción o una sola imagen inicial. La edición clásica Grok Imagine Video ofrece flujos de edición y ampliación de vídeo. Estas distinciones ayudan a elegir un modelo según los materiales de entrada disponibles, en lugar de tratar a todos los miembros de la familia como el mismo generador.
Revise el plano completado para comprobar la continuidad del sujeto, la plausibilidad del movimiento, el encuadre y el sonido solicitado. Con diálogo, examine tanto las palabras como su sincronización con el personaje. Al preparar varios clips para una secuencia, conserve en cada encargo la descripción pertinente del sujeto o la imagen inicial y evalúe las uniones durante la edición. Un plano corto bien especificado es más fácil de diagnosticar: la revisión puede identificar si el siguiente cambio debe afectar a la imagen de origen, la acción, la cámara o la frase hablada.
", "aboutText": "Grok Imagine Video 1.5 Lite es la edición simplificada de generación de la familia de vídeo Grok Imagine. El fabricante la recomienda para trabajos sencillos de texto a vídeo e imagen a vídeo. Una escena escrita puede convertirse en un clip corto, o una imagen fija proporcionada puede servir como fotograma inicial de un plano animado. La salida incluye audio generado y esta edición admite voz con sincronización labial. Entre los entregables útiles están un breve movimiento de producto, un plano de situación atmosférico o un momento sencillo de un personaje que habla.\n\nPara texto a vídeo, describa lo que se ve, lo que ocurre durante el plano y cómo debe observarlo la cámara. Incluya iluminación, ritmo y sonido pertinente. El fabricante explica que Lite primero genera una imagen a partir de la instrucción y después la anima; esa imagen intermedia no se devuelve como recurso independiente. Como preparación práctica, asigne al clip corto un acontecimiento claro y espacio suficiente para que se desarrolle. Un entorno exterior amplio, un detalle cercano de producto y un retrato hablado requieren indicaciones diferentes de composición y movimiento.\n\nPor ejemplo, un encargo original podría pedir un acercamiento lento a una taza de cerámica sobre una tranquila mesa de desayuno mientras asciende vapor, con luz suave de mañana y ambiente discreto de habitación. Lo importante al revisar el resultado es si la taza sigue siendo reconocible, el vapor se mueve de forma natural y la cámara sigue la dirección prevista. Mantenga sencillo el movimiento de ese ejemplo al evaluar el plano. Si un personaje habla, incluya la frase prevista y una descripción concisa de la interpretación; después compruebe las palabras y el movimiento visible de la boca en el resultado.\n\nPara imagen a vídeo, la imagen establece el primer fotograma y la instrucción describe lo que ocurre después. Elija una imagen inicial con el sujeto, el encuadre y los detalles visuales previstos ya presentes. Dé instrucciones de movimiento que encajen con la composición existente, como un pequeño giro de cabeza, un movimiento suave de cámara o viento que afecte a la tela. La salida sigue la relación de aspecto de la imagen; el ajuste independiente de relación de aspecto se ignora en este modo. Prepare de antemano un recorte vertical cuando el clip final necesite ese encuadre.\n\nLa duración documentada de salida es de 1–15 segundos, con ocho segundos como valor predeterminado. Texto a vídeo ofrece composiciones cuadradas, horizontales, verticales y más anchas, incluidas 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 y 5:2. Decida cómo se utilizará el plano antes de seleccionar el encuadre. Un clip vertical para redes puede necesitar espacio para añadir subtítulos después, mientras que un inserto horizontal puede necesitar margen alrededor del sujeto para que quien edite pueda cortar con comodidad. Ajuste la acción solicitada a la duración del clip, en lugar de comprimir una secuencia larga en un plano breve.\n\nLite ofrece salida de 480p y 720p, además de una opción de 1080p obtenida ampliando 720p. Esta distinción importa al planificar material sensible al detalle: un fotograma de salida mayor no significa que esta edición genere la escena de forma nativa a 1080p. Compruebe las letras pequeñas, los bordes de producto y los rostros al tamaño de visualización previsto. Los vídeos generados incluyen audio de forma predeterminada y la configuración de generación del fabricante también permite un resultado silencioso. Especifique la intención sonora con tanto cuidado como la acción visible cuando el clip vaya a utilizarse con su pista generada.\n\nLa generación es asíncrona en la interfaz documentada del fabricante. Un identificador de solicitud permite seguir el trabajo mientras está pendiente; una respuesta completada proporciona la ubicación del vídeo y su duración. El ejemplo completado de la guía apunta a un clip MP4 y explica que las ubicaciones de salida son temporales. Conserve el resultado completado al preparar una edición, junto con la instrucción, la imagen de origen y los ajustes elegidos. Una tarea enviada sigue siendo una fase de procesamiento; el resultado útil de producción es el clip reproducible con la imagen y el sonido requeridos.\n\nLa elección de edición depende de los controles necesarios para el plano. La versión completa Grok Imagine Video 1.5 añade referencias de varias imágenes, referencias de voz seleccionadas, primeros o últimos fotogramas exactos y fotogramas intermedios fijados, y genera texto o imagen a vídeo a 1080p nativos. Lite se concentra en una instrucción o una sola imagen inicial. La edición clásica Grok Imagine Video ofrece flujos de edición y ampliación de vídeo. Estas distinciones ayudan a elegir un modelo según los materiales de entrada disponibles, en lugar de tratar a todos los miembros de la familia como el mismo generador.\n\nRevise el plano completado para comprobar la continuidad del sujeto, la plausibilidad del movimiento, el encuadre y el sonido solicitado. Con diálogo, examine tanto las palabras como su sincronización con el personaje. Al preparar varios clips para una secuencia, conserve en cada encargo la descripción pertinente del sujeto o la imagen inicial y evalúe las uniones durante la edición. Un plano corto bien especificado es más fácil de diagnosticar: la revisión puede identificar si el siguiente cambio debe afectar a la imagen de origen, la acción, la cámara o la frase hablada.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "93319ca1b6f85109e5362ca9b8e5e7159f8a4826a70cea6c620e8390dbe6abc7", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "es", "methods": [ { "html": "x-ai/grok-imagine-video-1.5-liteGrok Imagine Video 1.5 Lite genera clips cortos con audio a partir de una escena escrita o una imagen inicial. Admite salida de 1–15 segundos, encuadres horizontales y verticales y voz con sincronización labial. Elija 480p o 720p directamente, o salida de 1080p ampliada desde 720p; los controles avanzados de referencias y fotogramas corresponden a la versión completa 1.5.
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.
Grok Imagine Video 1.5 Lite es la edición simplificada de generación de la familia de vídeo Grok Imagine. El fabricante la recomienda para trabajos sencillos de texto a vídeo e imagen a vídeo. Una escena escrita puede convertirse en un clip corto, o una imagen fija proporcionada puede servir como fotograma inicial de un plano animado. La salida incluye audio generado y esta edición admite voz con sincronización labial. Entre los entregables útiles están un breve movimiento de producto, un plano de situación atmosférico o un momento sencillo de un personaje que habla.
Para texto a vídeo, describa lo que se ve, lo que ocurre durante el plano y cómo debe observarlo la cámara. Incluya iluminación, ritmo y sonido pertinente. El fabricante explica que Lite primero genera una imagen a partir de la instrucción y después la anima; esa imagen intermedia no se devuelve como recurso independiente. Como preparación práctica, asigne al clip corto un acontecimiento claro y espacio suficiente para que se desarrolle. Un entorno exterior amplio, un detalle cercano de producto y un retrato hablado requieren indicaciones diferentes de composición y movimiento.
Por ejemplo, un encargo original podría pedir un acercamiento lento a una taza de cerámica sobre una tranquila mesa de desayuno mientras asciende vapor, con luz suave de mañana y ambiente discreto de habitación. Lo importante al revisar el resultado es si la taza sigue siendo reconocible, el vapor se mueve de forma natural y la cámara sigue la dirección prevista. Mantenga sencillo el movimiento de ese ejemplo al evaluar el plano. Si un personaje habla, incluya la frase prevista y una descripción concisa de la interpretación; después compruebe las palabras y el movimiento visible de la boca en el resultado.
Para imagen a vídeo, la imagen establece el primer fotograma y la instrucción describe lo que ocurre después. Elija una imagen inicial con el sujeto, el encuadre y los detalles visuales previstos ya presentes. Dé instrucciones de movimiento que encajen con la composición existente, como un pequeño giro de cabeza, un movimiento suave de cámara o viento que afecte a la tela. La salida sigue la relación de aspecto de la imagen; el ajuste independiente de relación de aspecto se ignora en este modo. Prepare de antemano un recorte vertical cuando el clip final necesite ese encuadre.
La duración documentada de salida es de 1–15 segundos, con ocho segundos como valor predeterminado. Texto a vídeo ofrece composiciones cuadradas, horizontales, verticales y más anchas, incluidas 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 y 5:2. Decida cómo se utilizará el plano antes de seleccionar el encuadre. Un clip vertical para redes puede necesitar espacio para añadir subtítulos después, mientras que un inserto horizontal puede necesitar margen alrededor del sujeto para que quien edite pueda cortar con comodidad. Ajuste la acción solicitada a la duración del clip, en lugar de comprimir una secuencia larga en un plano breve.
Lite ofrece salida de 480p y 720p, además de una opción de 1080p obtenida ampliando 720p. Esta distinción importa al planificar material sensible al detalle: un fotograma de salida mayor no significa que esta edición genere la escena de forma nativa a 1080p. Compruebe las letras pequeñas, los bordes de producto y los rostros al tamaño de visualización previsto. Los vídeos generados incluyen audio de forma predeterminada y la configuración de generación del fabricante también permite un resultado silencioso. Especifique la intención sonora con tanto cuidado como la acción visible cuando el clip vaya a utilizarse con su pista generada.
La generación es asíncrona en la interfaz documentada del fabricante. Un identificador de solicitud permite seguir el trabajo mientras está pendiente; una respuesta completada proporciona la ubicación del vídeo y su duración. El ejemplo completado de la guía apunta a un clip MP4 y explica que las ubicaciones de salida son temporales. Conserve el resultado completado al preparar una edición, junto con la instrucción, la imagen de origen y los ajustes elegidos. Una tarea enviada sigue siendo una fase de procesamiento; el resultado útil de producción es el clip reproducible con la imagen y el sonido requeridos.
La elección de edición depende de los controles necesarios para el plano. La versión completa Grok Imagine Video 1.5 añade referencias de varias imágenes, referencias de voz seleccionadas, primeros o últimos fotogramas exactos y fotogramas intermedios fijados, y genera texto o imagen a vídeo a 1080p nativos. Lite se concentra en una instrucción o una sola imagen inicial. La edición clásica Grok Imagine Video ofrece flujos de edición y ampliación de vídeo. Estas distinciones ayudan a elegir un modelo según los materiales de entrada disponibles, en lugar de tratar a todos los miembros de la familia como el mismo generador.
Revise el plano completado para comprobar la continuidad del sujeto, la plausibilidad del movimiento, el encuadre y el sonido solicitado. Con diálogo, examine tanto las palabras como su sincronización con el personaje. Al preparar varios clips para una secuencia, conserve en cada encargo la descripción pertinente del sujeto o la imagen inicial y evalúe las uniones durante la edición. Un plano corto bien especificado es más fácil de diagnosticar: la revisión puede identificar si el siguiente cambio debe afectar a la imagen de origen, la acción, la cámara o la frase hablada.
POST /v1/videostext, imagevideo| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites x-ai/grok-imagine-video-1.5-lite | Predeterminado— |
Campoprompt | Tipostring | RequisitoObligatorio | Valores y límites | Predeterminado— |
Campoduration | Tipointeger | RequisitoObligatorio | Valores y límites 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Mínimo: 1 Máximo: 600 | Predeterminado— |
Camporesolution | Tipostring | RequisitoOpcional | Valores y límites 480p, 720p, 1080p | Predeterminado— |
Campoaspect_ratio | Tipostring | RequisitoOpcional | Valores y límites 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 | Predeterminado— |
Campogenerate_audio | Tipoboolean | RequisitoOpcional | Valores y límites false | Predeterminado— |
Campoframe_images | Tipoarray | RequisitoOpcional | Valores y límites Número mínimo de elementos: 1 Número máximo de elementos: 1 Contenido de entrada: Lista de objetos de fotograma. Cada objeto contiene type=image_url, image_url con url y frame_type. Usa una URL HTTPS de imagen y establece frame_type en first_frame. Cada función de fotograma aparece como máximo una vez. Claves exactas: type, image_url, frame_type Condiciones: Estas claves describen cada objeto de fotograma; image_url solo contiene url. Omite frame_images para una solicitud que solo contenga texto. | Predeterminado— |
Campoinput_references | Tipoarray | RequisitoOpcional | Valores y límites | Predeterminado— |
Campocallback_url | Tipostring | RequisitoOpcional | Valores y límites Patrón: ^https:// | Predeterminado— |
Camposession_id | Tipostring | RequisitoOpcional | Valores y límites | Predeterminado— |
Campotrace | Tipoobject | RequisitoOpcional | Valores y límites | Predeterminado— |
Campouser | Tipostring | RequisitoOpcional | Valores y límites | Predeterminado— |
Texto a vídeo · Una instrucción escrita. · Obligatorio: model, prompt, duration
Proporciona prompt como texto y duration en segundos enteros. Elige una resolución compatible y, si hace falta, una relación de aspecto.
model: Tipo: string · x-ai/grok-imagine-video-1.5-lite
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 del primer fotograma. · Obligatorio: model, prompt, duration, frame_images
frame_images es una lista. Cada objeto de fotograma incluye type, image_url y frame_type; image_url contiene url. Establece type en image_url. Usa first_frame. Cada función de fotograma aparece como máximo una vez. Proporciona una URL HTTPS pública de imagen para cada fotograma. Elige una resolución compatible y, si hace falta, una relación de aspecto.
Claves exactas: type, image_url, frame_type
model: Tipo: string · x-ai/grok-imagine-video-1.5-lite
prompt: Tipo: string · Máximo de bytes UTF-8: 10.000 · Se requiere contenido distinto de espacios en blanco: Sí
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, prompt, duration |
Parámetromaterial_types | Contratotext, image |
Parámetroadditional_properties | Contratofalse |
Parámetrooptional_controls | Contratoresolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user |
Ciclo de vida: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
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.
Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.
| Configuración | Tabla de tarifas | Cantidad prevista | Unidad de facturación | Condiciones de facturación | Cargo |
|---|---|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cantidad 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ónImagen de entrada | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor imagen | Condiciones de facturaciónNo se declara ninguna condición adicional en esta clave de precios. | Cargo Entrada · Imagen de entrada · Estimación solo para comparar $0.02 por imagen |
| ConfiguraciónPrecio del vídeo | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor segundo de vídeo | Condiciones de facturaciónresolution: 1080p | Cargo Salida · Precio del vídeo · Estimación solo para comparar $0.28 por segundo de vídeo |
| ConfiguraciónPrecio del vídeo | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor segundo de vídeo | Condiciones de facturaciónresolution: 480p | Cargo Salida · Precio del vídeo · Estimación solo para comparar $0.04 por segundo de vídeo |
| ConfiguraciónPrecio del vídeo | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor segundo de vídeo | Condiciones de facturaciónresolution: 720p | Cargo Salida · Precio del vídeo · Estimación solo para comparar $0.06 por segundo de vídeo |
| ConfiguraciónCoste estimado de generación | Tabla de tarifas— | Cantidad previstaestimación para una generación | Unidad de facturación— | Condiciones de facturación— | Cargo Salida · Coste estimado de generación · Estimación solo para comparar $0.04 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 →
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.
Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.
| Configuración | Condiciones de facturación | Cargo |
|---|---|---|
| ConfiguraciónImagen de entrada | Condiciones de facturaciónNo se declara ninguna condición adicional en esta clave de precios. | Cargo Entrada · Imagen de entrada $0.02 por imagen Referencia de precios publicada para la configuración mostrada. Los cargos finales se calculan según la configuración realmente facturada. |
| ConfiguraciónPrecio del vídeo | Condiciones de facturaciónresolution: 480p | Cargo Salida · Precio del vídeo $0.04 por segundo de vídeo Referencia de precios publicada para la configuración mostrada. Los cargos finales se calculan según la configuración realmente facturada. |
| ConfiguraciónPrecio del vídeo | Condiciones de facturaciónresolution: 720p | Cargo Salida · Precio del vídeo $0.06 por segundo de vídeo Referencia de precios publicada para la configuración mostrada. Los cargos finales se calculan según la configuración realmente facturada. |
| ConfiguraciónPrecio del vídeo | Condiciones de facturaciónresolution: 1080p | Cargo Salida · Precio del vídeo $0.28 por segundo de vídeo Referencia de precios publicada para la configuración mostrada. Los cargos finales se calculan según la configuración realmente facturada. |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"x-ai/grok-imagine-video-1.5-lite","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', 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\nURL firmadas de contenido bajo tu titularidad
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/contentset -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\nset -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\nGuarda 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.
503 result_pending_check + originalid + X-Should-Retry:false; no repitas nunca la operación original
| Campo | Tipo | Significado |
|---|---|---|
Campoindex | Tipointeger | SignificadoPosición de este vídeo en la lista de resultados, empezando por cero. |
Campocontent_url | Tipostring | SignificadoURL HTTPS firmada de descarga de este vídeo completado. |
Camposha256 | Tipostring | null | SignificadoHuella SHA-256 de los bytes del vídeo original; null si no está disponible. |
Camposize_bytes | Tipointeger | null | SignificadoTamaño del archivo de vídeo original en bytes; null si no está disponible. |
Campoduration_ms | Tipointeger | null | SignificadoDuración medida del vídeo en milisegundos; null si no está disponible. |
Campowidth | Tipointeger | null | SignificadoAnchura del vídeo en píxeles; null si no está disponible. |
Campoheight | Tipointeger | null | SignificadoAltura del vídeo en píxeles; null si no está disponible. |
Campovideo_codec | Tipostring | null | SignificadoIdentificador del códec de vídeo; null si no se ha registrado. |
Campohas_audio | Tipoboolean | null | SignificadoIndica si el vídeo contiene una pista de audio; null si no se ha medido. |
Campoaudio_codec | Tipostring | null | SignificadoIdentificador del códec de audio; null cuando no se ha registrado ninguno. |
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta404 · not_found_error | Condició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_error | Condició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_error | Condició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_unavailable | Condició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_error | Condició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_error | Condició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_error | Condició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_check | Condició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_unavailable | Condició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_ready | Condició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. |
Ailoot Ultra x-ai/grok-imagine-video-1.5-lite
Usa las rutas de método indicadas arriba.