Veo 3.1 Fast es el perfil rápido de generación de vídeo de Google para una escena breve descrita mediante texto o establecida por una imagen. Combina el plano visual con sonido generado y admite fotogramas iniciales y finales guiados. Úsalo para desarrollar un concepto de escena, preparar variaciones creativas breves o crear un segmento audiovisual compacto con una acción y una dirección visual claras.
Construye el encargo alrededor del sujeto, la acción y el entorno. Después añade el encuadre, el movimiento de cámara, la iluminación y el tratamiento visual que hacen útil el plano. Un encargo original de producto podría mostrar una pequeña lámpara de cerámica sobre un escritorio de madera, con la cámara acercándose lentamente mientras la luz se enciende y un discreto sonido de interruptor acompaña la acción. El sujeto y el evento visible describen la imagen; la dirección sonora describe la experiencia de escucha.
Escribe las indicaciones de escena en inglés, tal como especifica el perfil de prompts del productor. Ajusta la acción principal a la duración del clip y distingue el movimiento de cámara del movimiento del sujeto. Un plano general de situación, un primer plano de una textura y un plano que sigue un objeto en movimiento responden a preguntas creativas distintas. Elige la vista que comunique el detalle previsto en lugar de combinar indicaciones de cámara inconexas en un plano breve.
Para una escena basada en imagen, prepara una imagen inicial clara que ya establezca el aspecto y la composición. El encargo de movimiento puede concentrarse entonces en el evento que sigue. Un fotograma final puede proporcionar un destino visual para la transición. Mantén coherentes los detalles importantes del sujeto y el estilo entre los fotogramas, o describe explícitamente la transformación prevista. Revisa la transición en sí, además de sus imágenes inicial y final.
El perfil de producción del fabricante admite clips de cuatro, seis u ocho segundos, encuadre horizontal 16:9 o vertical 9:16 y hasta cuatro vídeos de salida por prompt. La salida Fast es de 720p o 1080p, a 24 fotogramas por segundo, en formato MP4. El perfil basado en imagen acepta JPEG o PNG, enumera un tamaño máximo de imagen de entrada de 20 MB y admite configuraciones de entrada 720p/1080p. Prepara la composición para su orientación prevista y mantén la entrada dentro de ese límite de imagen.
El sonido puede formar parte de la escena generada. Describe cualquier frase hablada, sonido ambiental o efecto pertinente junto con la acción visible, identificando al sujeto que debe hablar y el evento que debe producir el sonido. Mantén el diálogo lo bastante breve para la interpretación prevista y distínguelo del ambiente o la música. La generación de audio sigue el encargo escrito de escena; una grabación de audio no figura entre las entradas normales documentadas para este perfil.
El perfil actual de producción también enumera la generación con referencias de recursos y la extensión de vídeo. Las referencias orientan el aspecto de un sujeto u objeto, mientras que los fotogramas de límite guían la composición inicial y final. Selecciona material de referencia cuya función en la escena sea clara, en lugar de tratar todas las imágenes como controles intercambiables. Para continuar un clip, elige el flujo independiente de extensión y describe qué debe suceder después de la acción existente; su tratamiento de entradas es distinto del de un plano nuevo basado en texto.
Una descripción negativa puede identificar contenidos o tratamientos visuales que quieras evitar. Mantén el prompt principal centrado en la escena que deseas y haz que las exclusiones sean específicas de la tarea. Para una variación de producto, conserva el sujeto y el encuadre mientras cambias un detalle, como la dirección de la luz o el tratamiento del material. Conserva los ajustes y el conjunto de referencias al comparar resultados para que la diferencia creativa siga siendo clara.
Veo 3.1 Fast y el perfil regular Veo 3.1 siguen siendo opciones distintas. La salida de producción Fast documentada es 720p/1080p; el perfil regular también enumera 4K. Conserva la edición seleccionada y sus ajustes de salida junto con el recurso en lugar de tratar un identificador Preview u otra versión de Veo como sinónimo automático de este perfil de producción.
El flujo crea una operación de generación y expone los archivos de vídeo devueltos tras la finalización. Conserva cada resultado real seleccionado para revisión junto con su encargo, fotogramas de origen y ajustes relevantes. Un identificador de operación es un registro de la generación; el recurso MP4 terminado es lo que puede reproducirse y utilizarse en la edición. Conserva cualquier metadato de procedencia de contenido proporcionado junto con el vídeo.
Revisa el aspecto del sujeto, la acción solicitada, el tratamiento de cámara y el sonido a lo largo del clip completo. Comprueba la inteligibilidad del diálogo y la relación entre el sonido y los eventos visibles antes de utilizarlo en una composición más larga. El resultado útil puede ser un plano conceptual, una presentación de producto o un segmento narrativo breve, con títulos, transiciones y otros trabajos de edición posteriores añadidos en el flujo de producción circundante.
", "aboutText": "Veo 3.1 Fast es el perfil rápido de generación de vídeo de Google para una escena breve descrita mediante texto o establecida por una imagen. Combina el plano visual con sonido generado y admite fotogramas iniciales y finales guiados. Úsalo para desarrollar un concepto de escena, preparar variaciones creativas breves o crear un segmento audiovisual compacto con una acción y una dirección visual claras.\n\nConstruye el encargo alrededor del sujeto, la acción y el entorno. Después añade el encuadre, el movimiento de cámara, la iluminación y el tratamiento visual que hacen útil el plano. Un encargo original de producto podría mostrar una pequeña lámpara de cerámica sobre un escritorio de madera, con la cámara acercándose lentamente mientras la luz se enciende y un discreto sonido de interruptor acompaña la acción. El sujeto y el evento visible describen la imagen; la dirección sonora describe la experiencia de escucha.\n\nEscribe las indicaciones de escena en inglés, tal como especifica el perfil de prompts del productor. Ajusta la acción principal a la duración del clip y distingue el movimiento de cámara del movimiento del sujeto. Un plano general de situación, un primer plano de una textura y un plano que sigue un objeto en movimiento responden a preguntas creativas distintas. Elige la vista que comunique el detalle previsto en lugar de combinar indicaciones de cámara inconexas en un plano breve.\n\nPara una escena basada en imagen, prepara una imagen inicial clara que ya establezca el aspecto y la composición. El encargo de movimiento puede concentrarse entonces en el evento que sigue. Un fotograma final puede proporcionar un destino visual para la transición. Mantén coherentes los detalles importantes del sujeto y el estilo entre los fotogramas, o describe explícitamente la transformación prevista. Revisa la transición en sí, además de sus imágenes inicial y final.\n\nEl perfil de producción del fabricante admite clips de cuatro, seis u ocho segundos, encuadre horizontal 16:9 o vertical 9:16 y hasta cuatro vídeos de salida por prompt. La salida Fast es de 720p o 1080p, a 24 fotogramas por segundo, en formato MP4. El perfil basado en imagen acepta JPEG o PNG, enumera un tamaño máximo de imagen de entrada de 20 MB y admite configuraciones de entrada 720p/1080p. Prepara la composición para su orientación prevista y mantén la entrada dentro de ese límite de imagen.\n\nEl sonido puede formar parte de la escena generada. Describe cualquier frase hablada, sonido ambiental o efecto pertinente junto con la acción visible, identificando al sujeto que debe hablar y el evento que debe producir el sonido. Mantén el diálogo lo bastante breve para la interpretación prevista y distínguelo del ambiente o la música. La generación de audio sigue el encargo escrito de escena; una grabación de audio no figura entre las entradas normales documentadas para este perfil.\n\nEl perfil actual de producción también enumera la generación con referencias de recursos y la extensión de vídeo. Las referencias orientan el aspecto de un sujeto u objeto, mientras que los fotogramas de límite guían la composición inicial y final. Selecciona material de referencia cuya función en la escena sea clara, en lugar de tratar todas las imágenes como controles intercambiables. Para continuar un clip, elige el flujo independiente de extensión y describe qué debe suceder después de la acción existente; su tratamiento de entradas es distinto del de un plano nuevo basado en texto.\n\nUna descripción negativa puede identificar contenidos o tratamientos visuales que quieras evitar. Mantén el prompt principal centrado en la escena que deseas y haz que las exclusiones sean específicas de la tarea. Para una variación de producto, conserva el sujeto y el encuadre mientras cambias un detalle, como la dirección de la luz o el tratamiento del material. Conserva los ajustes y el conjunto de referencias al comparar resultados para que la diferencia creativa siga siendo clara.\n\nVeo 3.1 Fast y el perfil regular Veo 3.1 siguen siendo opciones distintas. La salida de producción Fast documentada es 720p/1080p; el perfil regular también enumera 4K. Conserva la edición seleccionada y sus ajustes de salida junto con el recurso en lugar de tratar un identificador Preview u otra versión de Veo como sinónimo automático de este perfil de producción.\n\nEl flujo crea una operación de generación y expone los archivos de vídeo devueltos tras la finalización. Conserva cada resultado real seleccionado para revisión junto con su encargo, fotogramas de origen y ajustes relevantes. Un identificador de operación es un registro de la generación; el recurso MP4 terminado es lo que puede reproducirse y utilizarse en la edición. Conserva cualquier metadato de procedencia de contenido proporcionado junto con el vídeo.\n\nRevisa el aspecto del sujeto, la acción solicitada, el tratamiento de cámara y el sonido a lo largo del clip completo. Comprueba la inteligibilidad del diálogo y la relación entre el sonido y los eventos visibles antes de utilizarlo en una composición más larga. El resultado útil puede ser un plano conceptual, una presentación de producto o un segmento narrativo breve, con títulos, transiciones y otros trabajos de edición posteriores añadidos en el flujo de producción circundante.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "f316380b193b642240d863ebe0b8f1fec8d99cc089b2f8900f1b2c509d1c5ebd", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "es", "methods": [ { "html": "google/veo-3.1-fastVeo 3.1 Fast es el modelo de vídeo de Google para escenas breves basadas en texto o imágenes, con sonido generado. Su perfil de producción devuelve clips MP4 de cuatro, seis u ocho segundos a 24 fps, con salida 720p o 1080p y fotogramas iniciales o finales guiados.
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.
Veo 3.1 Fast es el perfil rápido de generación de vídeo de Google para una escena breve descrita mediante texto o establecida por una imagen. Combina el plano visual con sonido generado y admite fotogramas iniciales y finales guiados. Úsalo para desarrollar un concepto de escena, preparar variaciones creativas breves o crear un segmento audiovisual compacto con una acción y una dirección visual claras.
Construye el encargo alrededor del sujeto, la acción y el entorno. Después añade el encuadre, el movimiento de cámara, la iluminación y el tratamiento visual que hacen útil el plano. Un encargo original de producto podría mostrar una pequeña lámpara de cerámica sobre un escritorio de madera, con la cámara acercándose lentamente mientras la luz se enciende y un discreto sonido de interruptor acompaña la acción. El sujeto y el evento visible describen la imagen; la dirección sonora describe la experiencia de escucha.
Escribe las indicaciones de escena en inglés, tal como especifica el perfil de prompts del productor. Ajusta la acción principal a la duración del clip y distingue el movimiento de cámara del movimiento del sujeto. Un plano general de situación, un primer plano de una textura y un plano que sigue un objeto en movimiento responden a preguntas creativas distintas. Elige la vista que comunique el detalle previsto en lugar de combinar indicaciones de cámara inconexas en un plano breve.
Para una escena basada en imagen, prepara una imagen inicial clara que ya establezca el aspecto y la composición. El encargo de movimiento puede concentrarse entonces en el evento que sigue. Un fotograma final puede proporcionar un destino visual para la transición. Mantén coherentes los detalles importantes del sujeto y el estilo entre los fotogramas, o describe explícitamente la transformación prevista. Revisa la transición en sí, además de sus imágenes inicial y final.
El perfil de producción del fabricante admite clips de cuatro, seis u ocho segundos, encuadre horizontal 16:9 o vertical 9:16 y hasta cuatro vídeos de salida por prompt. La salida Fast es de 720p o 1080p, a 24 fotogramas por segundo, en formato MP4. El perfil basado en imagen acepta JPEG o PNG, enumera un tamaño máximo de imagen de entrada de 20 MB y admite configuraciones de entrada 720p/1080p. Prepara la composición para su orientación prevista y mantén la entrada dentro de ese límite de imagen.
El sonido puede formar parte de la escena generada. Describe cualquier frase hablada, sonido ambiental o efecto pertinente junto con la acción visible, identificando al sujeto que debe hablar y el evento que debe producir el sonido. Mantén el diálogo lo bastante breve para la interpretación prevista y distínguelo del ambiente o la música. La generación de audio sigue el encargo escrito de escena; una grabación de audio no figura entre las entradas normales documentadas para este perfil.
El perfil actual de producción también enumera la generación con referencias de recursos y la extensión de vídeo. Las referencias orientan el aspecto de un sujeto u objeto, mientras que los fotogramas de límite guían la composición inicial y final. Selecciona material de referencia cuya función en la escena sea clara, en lugar de tratar todas las imágenes como controles intercambiables. Para continuar un clip, elige el flujo independiente de extensión y describe qué debe suceder después de la acción existente; su tratamiento de entradas es distinto del de un plano nuevo basado en texto.
Una descripción negativa puede identificar contenidos o tratamientos visuales que quieras evitar. Mantén el prompt principal centrado en la escena que deseas y haz que las exclusiones sean específicas de la tarea. Para una variación de producto, conserva el sujeto y el encuadre mientras cambias un detalle, como la dirección de la luz o el tratamiento del material. Conserva los ajustes y el conjunto de referencias al comparar resultados para que la diferencia creativa siga siendo clara.
Veo 3.1 Fast y el perfil regular Veo 3.1 siguen siendo opciones distintas. La salida de producción Fast documentada es 720p/1080p; el perfil regular también enumera 4K. Conserva la edición seleccionada y sus ajustes de salida junto con el recurso en lugar de tratar un identificador Preview u otra versión de Veo como sinónimo automático de este perfil de producción.
El flujo crea una operación de generación y expone los archivos de vídeo devueltos tras la finalización. Conserva cada resultado real seleccionado para revisión junto con su encargo, fotogramas de origen y ajustes relevantes. Un identificador de operación es un registro de la generación; el recurso MP4 terminado es lo que puede reproducirse y utilizarse en la edición. Conserva cualquier metadato de procedencia de contenido proporcionado junto con el vídeo.
Revisa el aspecto del sujeto, la acción solicitada, el tratamiento de cámara y el sonido a lo largo del clip completo. Comprueba la inteligibilidad del diálogo y la relación entre el sonido y los eventos visibles antes de utilizarlo en una composición más larga. El resultado útil puede ser un plano conceptual, una presentación de producto o un segmento narrativo breve, con títulos, transiciones y otros trabajos de edición posteriores añadidos en el flujo de producción circundante.
POST /v1/videostextvideo| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites google/veo-3.1-fast | Predeterminado— |
Campoprompt | Tipostring | RequisitoObligatorio | Valores y límites Máximo de bytes UTF-8: 10.000 Se requiere contenido distinto de espacios en blanco: Sí | Predeterminado— |
Campoduration | Tipointeger | RequisitoObligatorio | Valores y límites 4, 6, 8 | Predeterminado— |
Camporesolution | Tipostring | RequisitoObligatorio | Valores y límites 720p | Predeterminado— |
Campoaspect_ratio | Tipostring | RequisitoObligatorio | Valores y límites 16:9, 9:16 | Predeterminado— |
Campogenerate_audio | Tipoboolean | RequisitoObligatorio | Valores y límites false, true | Predeterminado— |
Texto a vídeo · Obligatorio: prompt
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, prompt, duration, resolution, aspect_ratio, generate_audio |
Parámetroadditional_properties | Contratofalse |
Parámetroparameters | Contrato{"name":"model","type":"string","required":true,"enum":["google/veo-3.1-fast"]}, {"name":"prompt","type":"string","required":true,"non_whitespace":true,"max_utf8_bytes":10000}, {"name":"duration","type":"integer","required":true,"enum":[4,6,8]}, {"name":"resolution","type":"string","required":true,"enum":["720p"]}, {"name":"aspect_ratio","type":"string","required":true,"enum":["16:9","9:16"]}, {"name":"generate_audio","type":"boolean","required":true,"enum":[false,true]} |
Parámetromaterial_types | Contratotext |
Alias de método: /v1/videos/generations, /videos, /videos/generations
Ciclo de vida: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Conserva la respuesta completa y los ID originales devueltos.
No vuelvas a enviar nunca una creación de resultado desconocido.
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 | Generar audio | Resolución | Unidad de facturación | Condiciones de facturación | Cargo |
|---|---|---|---|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cantidad prevista— | Generar audio— | Resolución— | 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 del vídeo | Tabla de tarifas— | Cantidad prevista— | Generar audio— | Resolución— | Unidad de facturaciónpor segundo de vídeo | Condiciones de facturaciónsonido: with_audio | Cargo Salida · Precio del vídeo · Estimación solo para comparar $0.24 por segundo de vídeo |
| ConfiguraciónPrecio del vídeo | Tabla de tarifas— | Cantidad prevista— | Generar audio— | Resolución— | Unidad de facturaciónpor segundo de vídeo | Condiciones de facturaciónaudio: with_audio; resolución: 4k | Cargo Salida · Precio del vídeo · Estimación solo para comparar $0.6 por segundo de vídeo |
| ConfiguraciónUltra | Tabla de tarifas— | Cantidad previstaConfiguración solicitada; solo una estimación. | Generar audioCon audio | Resolución720p | Unidad de facturaciónpor segundo de vídeo de salida | Condiciones de facturación— | Cargo Salida · Segundo estimado de vídeo de salida · Estimación solo para comparar $0.2 por segundo de vídeo de salida La tarifa mostrada estima el coste antes de generar. El cargo definitivo se calcula a partir del coste registrado para la generación original. La duración física del vídeo no es la cantidad facturable. |
| ConfiguraciónPrecio del vídeo | Tabla de tarifas— | Cantidad prevista— | Generar audio— | Resolución— | Unidad de facturaciónpor segundo de vídeo | Condiciones de facturaciónsonido: without_audio | Cargo Salida · Precio del vídeo · Estimación solo para comparar $0.2 por segundo de vídeo |
| ConfiguraciónPrecio del vídeo | Tabla de tarifas— | Cantidad prevista— | Generar audio— | Resolución— | Unidad de facturaciónpor segundo de vídeo | Condiciones de facturaciónaudio: without_audio; resolución: 4k | Cargo Salida · Precio del vídeo · Estimación solo para comparar $0.5 por segundo de vídeo |
| ConfiguraciónUltra | Tabla de tarifas— | Cantidad previstaConfiguración solicitada; solo una estimación. | Generar audioSin audio | Resolución720p | Unidad de facturaciónpor segundo de vídeo de salida | Condiciones de facturación— | Cargo Salida · Segundo estimado de vídeo de salida · Estimación solo para comparar $0.16 por segundo de vídeo de salida La tarifa mostrada estima el coste antes de la generación. El cargo definitivo se calcula a partir del coste registrado para la generación original. La duración física del vídeo no es la cantidad facturable. |
| ConfiguraciónCoste estimado de generación | Tabla de tarifas— | Cantidad previstaestimación para una generación | Generar audio— | Resolución— | Unidad de facturación— | Condiciones de facturación— | Cargo Salida · Coste estimado de generación · Estimación solo para comparar $0.64 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ónPrecio del vídeo | Condiciones de facturaciónsonido: with_audio | Cargo Salida · Precio del vídeo $0.24 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ónaudio: with_audio; resolución: 4k | Cargo Salida · Precio del vídeo $0.6 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ónsonido: without_audio | Cargo Salida · Precio del vídeo $0.2 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ónaudio: with_audio; resolución: 720p | Cargo Salida · Precio del vídeo $0.2 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ónaudio: without_audio; resolución: 4k | Cargo Salida · Precio del vídeo $0.5 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ónaudio: without_audio; resolución: 720p | Cargo Salida · Precio del vídeo $0.16 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'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "google/veo-3.1-fast", "prompt": "a calm greenhouse", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true}')\nPath('request.json').write_text(json.dumps(p,ensure_ascii=False))\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\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_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 cada URL firmada de un recurso bajo tu titularidad en data[] completado y todos los metadatos del estado. Guarda todos los resultados, incluido el audio generado. Puede haber una pista de audio AAC válida incluso con generate_audio=false; conserva el MP4 original completo, incluido ese audio.
Consulta el trabajo original existente; no vuelvas a enviar nunca un envío de resultado desconocido.
Máximo de salidas: 4.
| Campo | Tipo | Significado |
|---|---|---|
Campoid | Tipostring | Significado— |
Campoobject | Tipostring | Significado— |
Campomodel | Tipostring | Significado— |
Campostatus | Tipostring | Significado— |
Campodata[] | Tiposigned content URL | Significado— |
Campocharge_pending_check | Tipoboolean | Significado— |
Campoerror.code | Tipostring | Significado— |
Campoerror.message | Tipostring | Significado— |
Campooperation_id | Tipostring | SignificadoRespuesta HTTP503 result_pending_check del estado o contenido original: el mismo ID público de vídeo original como id. |
Campoerror.type | Tipostring | Significadoserver_error con HTTP503 result_pending_check. |
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta400 · invalid_request_error | CondiciónNo se puede leer el cuerpo sin procesar de la solicitud antes de analizar el perfil de vídeo | Siguiente pasoConserva la respuesta devuelta y corrige el cuerpo ilegible de la solicitud. |
Respuesta422 · price_unavailable | CondiciónNo se puede analizar el perfil exacto de vídeo, o el perfil completo analizado no tiene una ficha de precios exacta lista para usar | Siguiente pasoConserva la respuesta; utiliza el perfil admitido exacto y completo y su ficha publicada. Esta rama se ejecuta antes del envío al proveedor. |
Respuesta409 · video_not_ready | CondiciónEl contenido del resultado original aún no está disponible | Siguiente pasoConsulta periódicamente el ID original devuelto y respeta Retry-After. |
Respuestaserver_error | CondiciónLa respuesta devuelta indica que la operación o el resultado requiere una comprobación | Siguiente pasoConserva el ID original de operación o tarea devuelto, las cabeceras de la solicitud y la respuesta; continúa con las lecturas admitidas de esa operación original. No vuelvas a enviar la solicitud de creación. |
Respuesta503 · result_pending_check | CondiciónGET del estado o contenido original: la tarea no está publicada, el trabajo original no está en failed/cancelled/expired y el estado local es unknown o el estado del trabajo original es completed. | Siguiente pasoConserva el id y el operation_id originales (el mismo ID público de vídeo), la respuesta y las cabeceras; consulta solo el estado o contenido original. No envíes nunca una nueva solicitud de generación. |
Ailoot Ultra google/veo-3.1-fast
/v1/videos/generations, /videos, /videos/generations