Kling VIDEO 3.0 Standard es el perfil de 720p de Kuaishou para generar una escena desde texto o imagen. Usa audio nativo, referencias de sujeto y narración de varias tomas de VIDEO 3.0, con duración flexible de tres a quince segundos. Sirve para desarrollar una dirección visual, previsualizar una narración corta o crear una escena compacta con acción y sonido definidos.
Para una escena con texto, establece sujeto, entorno, acción, luz y cámara. Para una con imagen, prepara un inicio que muestre claramente apariencia y composición a animar. Un encargo original podría mostrar un personaje junto a una mesa de taller y describir que toma un objeto pequeño mientras la cámara se acerca. Separa en la redacción movimiento del sujeto y de cámara.
La generación de varias tomas puede planear automáticamente la cobertura desde la descripción. La dirección personalizada asigna contenido y duración a cada toma. El perfil del fabricante acepta de una a seis tomas, máximo 512 caracteres por toma y al menos un segundo cada una. Las duraciones deben sumar la longitud total. Cuando una vista continua comunica claramente la escena, una instrucción de toma única evita transiciones innecesarias.
Un storyboard breve puede comenzar con el entorno, pasar a la acción y terminar en el detalle que explica el resultado. Especifica qué sujeto permanece y cómo cambia el encuadre. El modo automático adapta la cobertura, mientras que una secuencia personalizada da instrucciones explícitas para cada parte. La instrucción normal única acepta hasta 2,500 caracteres en la referencia del fabricante.
Los controles de referencia ayudan a anclar personajes, objetos y entorno. Usa material claro y una descripción estable para cada sujeto. El perfil documentado basado en imagen permite hasta tres elementos preparados. Para una escena ilustrada de producto, una referencia puede establecer el objeto y la composición inicial dónde está; la instrucción de movimiento describe el evento a su alrededor. Comprueba la apariencia en toda la toma en vez de suponer que la referencia evita cualquier cambio.
Los extremos pueden guiar una transición condicionada por imagen hacia una composición final. Usa fotogramas con conexión plausible y describe la acción entre ellos. El perfil acepta JPG, JPEG y PNG de hasta 10 MB, con dimensiones de al menos 300 píxeles; la relación inicial debe estar entre 1:2.5 y 2.5:1. Prepara los fotogramas para esa tarea en vez de tratar una descripción de storyboard como paquete intercambiable de entradas.
Standard puede generar audio nativo al activar ese modo; la referencia lo deja apagado por defecto. Describe líneas, atmósfera y sonidos pertinentes como parte de la escena. VIDEO 3.0 admite tratamientos de habla en chino, inglés, japonés, coreano y español, incluidos cambios de idioma y acentos o dialectos compatibles. La guía dice que el diálogo escrito en otro idioma se traduce al inglés. Identifica claramente al hablante en escenas con varios personajes y deja las líneas lo bastante cortas para la interpretación.
Un encargo original puede asignar una línea al Hablante A, una reacción visible al Hablante B y un cambio de vista acorde con el intercambio. Describe el sonido del entorno aparte del diálogo para que un efecto de fondo no se vuelva una instrucción ambigua sobre habla. Usa referencias para apariencia y texto para acciones y palabras.
Las letras visibles también forman parte del flujo 3.0. Una imagen fuente puede contener letrero, subtítulo o etiqueta de producto cuya apariencia importe durante la animación. Identifica el texto y su función y revisa ortografía, legibilidad y estabilidad. Para una pieza breve de campaña, destaca el mensaje principal en la composición en vez de depender de una etiqueta diminuta de fondo.
La salida Standard es 720p. Pro es el perfil 1080p seleccionado por separado y 4K nativo es otro modo del fabricante, no un ajuste automático de Standard. Las relaciones de texto incluyen 16:9, 9:16 y 1:1. Elige formato y encuadre para la ubicación prevista y conserva esa dirección visual al comparar cambios de acción, luz u orden de tomas.
Una generación completada aporta video y duración real. La documentación indica que los videos se eliminan después de 30 días, así que guarda pronto el clip. Conserva encargo, referencias y perfil para mantener un punto de partida consistente en futuras revisiones. Revisa acción, continuidad, cobertura de cámara, diálogo y letras en el contexto de uso. Corregir el detalle fallido sirve más que sustituir todo el encargo por instrucciones inconexas.
", "aboutText": "Kling VIDEO 3.0 Standard es el perfil de 720p de Kuaishou para generar una escena desde texto o imagen. Usa audio nativo, referencias de sujeto y narración de varias tomas de VIDEO 3.0, con duración flexible de tres a quince segundos. Sirve para desarrollar una dirección visual, previsualizar una narración corta o crear una escena compacta con acción y sonido definidos.\n\nPara una escena con texto, establece sujeto, entorno, acción, luz y cámara. Para una con imagen, prepara un inicio que muestre claramente apariencia y composición a animar. Un encargo original podría mostrar un personaje junto a una mesa de taller y describir que toma un objeto pequeño mientras la cámara se acerca. Separa en la redacción movimiento del sujeto y de cámara.\n\nLa generación de varias tomas puede planear automáticamente la cobertura desde la descripción. La dirección personalizada asigna contenido y duración a cada toma. El perfil del fabricante acepta de una a seis tomas, máximo 512 caracteres por toma y al menos un segundo cada una. Las duraciones deben sumar la longitud total. Cuando una vista continua comunica claramente la escena, una instrucción de toma única evita transiciones innecesarias.\n\nUn storyboard breve puede comenzar con el entorno, pasar a la acción y terminar en el detalle que explica el resultado. Especifica qué sujeto permanece y cómo cambia el encuadre. El modo automático adapta la cobertura, mientras que una secuencia personalizada da instrucciones explícitas para cada parte. La instrucción normal única acepta hasta 2,500 caracteres en la referencia del fabricante.\n\nLos controles de referencia ayudan a anclar personajes, objetos y entorno. Usa material claro y una descripción estable para cada sujeto. El perfil documentado basado en imagen permite hasta tres elementos preparados. Para una escena ilustrada de producto, una referencia puede establecer el objeto y la composición inicial dónde está; la instrucción de movimiento describe el evento a su alrededor. Comprueba la apariencia en toda la toma en vez de suponer que la referencia evita cualquier cambio.\n\nLos extremos pueden guiar una transición condicionada por imagen hacia una composición final. Usa fotogramas con conexión plausible y describe la acción entre ellos. El perfil acepta JPG, JPEG y PNG de hasta 10 MB, con dimensiones de al menos 300 píxeles; la relación inicial debe estar entre 1:2.5 y 2.5:1. Prepara los fotogramas para esa tarea en vez de tratar una descripción de storyboard como paquete intercambiable de entradas.\n\nStandard puede generar audio nativo al activar ese modo; la referencia lo deja apagado por defecto. Describe líneas, atmósfera y sonidos pertinentes como parte de la escena. VIDEO 3.0 admite tratamientos de habla en chino, inglés, japonés, coreano y español, incluidos cambios de idioma y acentos o dialectos compatibles. La guía dice que el diálogo escrito en otro idioma se traduce al inglés. Identifica claramente al hablante en escenas con varios personajes y deja las líneas lo bastante cortas para la interpretación.\n\nUn encargo original puede asignar una línea al Hablante A, una reacción visible al Hablante B y un cambio de vista acorde con el intercambio. Describe el sonido del entorno aparte del diálogo para que un efecto de fondo no se vuelva una instrucción ambigua sobre habla. Usa referencias para apariencia y texto para acciones y palabras.\n\nLas letras visibles también forman parte del flujo 3.0. Una imagen fuente puede contener letrero, subtítulo o etiqueta de producto cuya apariencia importe durante la animación. Identifica el texto y su función y revisa ortografía, legibilidad y estabilidad. Para una pieza breve de campaña, destaca el mensaje principal en la composición en vez de depender de una etiqueta diminuta de fondo.\n\nLa salida Standard es 720p. Pro es el perfil 1080p seleccionado por separado y 4K nativo es otro modo del fabricante, no un ajuste automático de Standard. Las relaciones de texto incluyen 16:9, 9:16 y 1:1. Elige formato y encuadre para la ubicación prevista y conserva esa dirección visual al comparar cambios de acción, luz u orden de tomas.\n\nUna generación completada aporta video y duración real. La documentación indica que los videos se eliminan después de 30 días, así que guarda pronto el clip. Conserva encargo, referencias y perfil para mantener un punto de partida consistente en futuras revisiones. Revisa acción, continuidad, cobertura de cámara, diálogo y letras en el contexto de uso. Corregir el detalle fallido sirve más que sustituir todo el encargo por instrucciones inconexas.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "c56540bb5732a883eae17e503df3c1f0428386dc098233bf98ea2bc50d22eec3", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "es-mx", "methods": [ { "html": "kwaivgi/kling-v3.0-stdKling VIDEO 3.0 Standard es el perfil de video de 720p de Kuaishou para encargos de texto e imagen. Crea escenas de tres a quince segundos con audio nativo, referencias de sujeto, guía de primer/último fotograma y narración de una o varias tomas.
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.
Kling VIDEO 3.0 Standard es el perfil de 720p de Kuaishou para generar una escena desde texto o imagen. Usa audio nativo, referencias de sujeto y narración de varias tomas de VIDEO 3.0, con duración flexible de tres a quince segundos. Sirve para desarrollar una dirección visual, previsualizar una narración corta o crear una escena compacta con acción y sonido definidos.
Para una escena con texto, establece sujeto, entorno, acción, luz y cámara. Para una con imagen, prepara un inicio que muestre claramente apariencia y composición a animar. Un encargo original podría mostrar un personaje junto a una mesa de taller y describir que toma un objeto pequeño mientras la cámara se acerca. Separa en la redacción movimiento del sujeto y de cámara.
La generación de varias tomas puede planear automáticamente la cobertura desde la descripción. La dirección personalizada asigna contenido y duración a cada toma. El perfil del fabricante acepta de una a seis tomas, máximo 512 caracteres por toma y al menos un segundo cada una. Las duraciones deben sumar la longitud total. Cuando una vista continua comunica claramente la escena, una instrucción de toma única evita transiciones innecesarias.
Un storyboard breve puede comenzar con el entorno, pasar a la acción y terminar en el detalle que explica el resultado. Especifica qué sujeto permanece y cómo cambia el encuadre. El modo automático adapta la cobertura, mientras que una secuencia personalizada da instrucciones explícitas para cada parte. La instrucción normal única acepta hasta 2,500 caracteres en la referencia del fabricante.
Los controles de referencia ayudan a anclar personajes, objetos y entorno. Usa material claro y una descripción estable para cada sujeto. El perfil documentado basado en imagen permite hasta tres elementos preparados. Para una escena ilustrada de producto, una referencia puede establecer el objeto y la composición inicial dónde está; la instrucción de movimiento describe el evento a su alrededor. Comprueba la apariencia en toda la toma en vez de suponer que la referencia evita cualquier cambio.
Los extremos pueden guiar una transición condicionada por imagen hacia una composición final. Usa fotogramas con conexión plausible y describe la acción entre ellos. El perfil acepta JPG, JPEG y PNG de hasta 10 MB, con dimensiones de al menos 300 píxeles; la relación inicial debe estar entre 1:2.5 y 2.5:1. Prepara los fotogramas para esa tarea en vez de tratar una descripción de storyboard como paquete intercambiable de entradas.
Standard puede generar audio nativo al activar ese modo; la referencia lo deja apagado por defecto. Describe líneas, atmósfera y sonidos pertinentes como parte de la escena. VIDEO 3.0 admite tratamientos de habla en chino, inglés, japonés, coreano y español, incluidos cambios de idioma y acentos o dialectos compatibles. La guía dice que el diálogo escrito en otro idioma se traduce al inglés. Identifica claramente al hablante en escenas con varios personajes y deja las líneas lo bastante cortas para la interpretación.
Un encargo original puede asignar una línea al Hablante A, una reacción visible al Hablante B y un cambio de vista acorde con el intercambio. Describe el sonido del entorno aparte del diálogo para que un efecto de fondo no se vuelva una instrucción ambigua sobre habla. Usa referencias para apariencia y texto para acciones y palabras.
Las letras visibles también forman parte del flujo 3.0. Una imagen fuente puede contener letrero, subtítulo o etiqueta de producto cuya apariencia importe durante la animación. Identifica el texto y su función y revisa ortografía, legibilidad y estabilidad. Para una pieza breve de campaña, destaca el mensaje principal en la composición en vez de depender de una etiqueta diminuta de fondo.
La salida Standard es 720p. Pro es el perfil 1080p seleccionado por separado y 4K nativo es otro modo del fabricante, no un ajuste automático de Standard. Las relaciones de texto incluyen 16:9, 9:16 y 1:1. Elige formato y encuadre para la ubicación prevista y conserva esa dirección visual al comparar cambios de acción, luz u orden de tomas.
Una generación completada aporta video y duración real. La documentación indica que los videos se eliminan después de 30 días, así que guarda pronto el clip. Conserva encargo, referencias y perfil para mantener un punto de partida consistente en futuras revisiones. Revisa acción, continuidad, cobertura de cámara, diálogo y letras en el contexto de uso. Corregir el detalle fallido sirve más que sustituir todo el encargo por instrucciones inconexas.
POST /v1/videostext, imagevideo| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites kwaivgi/kling-v3.0-std | Predeterminado— |
Campoprompt | Tipostring | RequisitoObligatorio | Valores y límites | Predeterminado— |
Campoduration | Tipointeger | RequisitoObligatorio | Valores y límites 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 720p | Predeterminado— |
Campoaspect_ratio | Tipostring | RequisitoOpcional | Valores y límites 16:9, 9:16, 1:1 | Predeterminado— |
Campogenerate_audio | Tipoboolean | RequisitoOpcional | Valores y límites false, true Condiciones: Omitir esta opción selecciona el precio con audio. Establécela en false para seleccionar el precio sin audio. Revisa has_audio en el resultado para saber si se devolvió una pista de audio. | Predeterminado— |
Campoframe_images | Tipoarray | RequisitoOpcional | Valores y límites Número mínimo de elementos: 1 Número máximo de elementos: 2 Contenido de entrada: Arreglo de objetos de fotograma. Cada objeto tiene type=image_url, image_url que contiene url y frame_type. Usa una URL HTTPS de imagen y establece frame_type en first_frame o last_frame. Cada función de fotograma puede aparecer como máximo una vez. Claves exactas: type, image_url, frame_type Condiciones: Estas claves describen cada objeto de fotograma; image_url contiene únicamente url. Omite frame_images para una solicitud de solo texto. | Predeterminado— |
Campoinput_references | Tipoarray | RequisitoOpcional | Valores y límites | Predeterminado— |
Camposize | Tipostring | RequisitoOpcional | Valores y límites 1280x720, 720x1280, 720x720 Patrón: ^[1-9][0-9]*x[1-9][0-9]*$ | 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 video · Una instrucción escrita. · Obligatorio: model, prompt, duration
Proporciona prompt como texto y duration en segundos enteros. Elige una resolución compatible; agrega una relación de aspecto o usa un tamaño de la lista.
model: Tipo: string · kwaivgi/kling-v3.0-std
prompt: Tipo: string · Máximo de bytes UTF-8: 10,000 · Se requiere contenido distinto de espacios en blanco: Sí
Imagen a video · Una instrucción escrita y una imagen del primer fotograma. · Obligatorio: model, prompt, duration, frame_images
frame_images es un arreglo. Cada objeto de fotograma tiene type, image_url y frame_type; image_url contiene url. Establece type en image_url. Usa first_frame con last_frame opcional. Cada función de fotograma puede aparecer como máximo una vez. Proporciona una URL HTTPS pública de imagen para cada fotograma. Elige una resolución compatible; agrega una relación de aspecto o usa un tamaño de la lista.
Claves exactas: type, image_url, frame_type
model: Tipo: string · kwaivgi/kling-v3.0-std
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, size, 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 permiten estimar el costo antes de la generación. El cargo final se calcula a partir del costo registrado para la generación original. La duración medida de la salida y las cantidades estimadas no son la cantidad facturable final.
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.
| Configuración | Tabla de tarifas | Cantidad prevista | Componente del cargo | Resolución de referencia | Modo de referencia | Audio de referencia | Unidad de facturación | Condiciones de facturación | Cargo |
|---|---|---|---|---|---|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cantidad prevista— | Componente del cargo— | Resolución de referencia— | Modo de referencia— | Audio de referencia— | 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ónSalida de video · tarifa de referencia | Tabla de tarifas— | Cantidad prevista— | Componente del cargoreference_output_rate | Resolución de referencia— | Modo de referencia— | Audio de referencia— | Unidad de facturaciónpor segundo de salida | Condiciones de facturación— | Cargo Salida · Tarifa de referencia por segundo de video de salida · Estimación solo para comparar $0.168 por segundo de salida |
| ConfiguraciónPrecio del video | Tabla de tarifas— | Cantidad prevista— | Componente del cargo— | Resolución de referencia— | Modo de referencia— | Audio de referencia— | Unidad de facturaciónpor segundo de video | Condiciones de facturaciónconfiguración de audio: with_audio | Cargo Salida · Precio del video · Estimación solo para comparar $0.252 por segundo de video |
| ConfiguraciónImagen a video (imágenes de fotogramas) · 1080p · tarifa de referencia | Tabla de tarifas— | Cantidad prevista— | Componente del cargoreference_output_rate | Resolución de referencia1080p | Modo de referenciaImagen a video (fotogramas) | Audio de referenciaSin audio | Unidad de facturaciónpor segundo de salida | Condiciones de facturación— | Cargo Salida · Tarifa de referencia por segundo de video de salida · Estimación solo para comparar $0.168 por segundo de salida |
| ConfiguraciónPrecio del video | Tabla de tarifas— | Cantidad prevista— | Componente del cargo— | Resolución de referencia— | Modo de referencia— | Audio de referencia— | Unidad de facturaciónpor segundo de video | Condiciones de facturaciónmodo de generación: image_to_video; resolución: 720p | Cargo Salida · Precio del video · Estimación solo para comparar $0.168 por segundo de video |
| ConfiguraciónTexto a video · 1080p · tarifa de referencia | Tabla de tarifas— | Cantidad prevista— | Componente del cargoreference_output_rate | Resolución de referencia1080p | Modo de referenciaTexto a video | Audio de referenciaSin audio | Unidad de facturaciónpor segundo de salida | Condiciones de facturación— | Cargo Salida · Tarifa de referencia por segundo de video de salida · Estimación solo para comparar $0.168 por segundo de salida |
| ConfiguraciónTexto a video · 480p · tarifa de referencia | Tabla de tarifas— | Cantidad prevista— | Componente del cargoreference_output_rate | Resolución de referencia480p | Modo de referenciaTexto a video | Audio de referenciaSin audio | Unidad de facturaciónpor segundo de salida | Condiciones de facturación— | Cargo Salida · Tarifa de referencia por segundo de video de salida · Estimación solo para comparar $0.168 por segundo de salida |
| ConfiguraciónPrecio del video | Tabla de tarifas— | Cantidad prevista— | Componente del cargo— | Resolución de referencia— | Modo de referencia— | Audio de referencia— | Unidad de facturaciónpor segundo de video | Condiciones de facturaciónmodo de generación: text_to_video; resolución: 720p | Cargo Salida · Precio del video · Estimación solo para comparar $0.168 por segundo de video |
| ConfiguraciónCosto estimado de generación | Tabla de tarifas— | Cantidad previstaestimación para una generación | Componente del cargo— | Resolución de referencia— | Modo de referencia— | Audio de referencia— | Unidad de facturación— | Condiciones de facturación— | Cargo Salida · Costo estimado de generación · Estimación solo para comparar $0.504 estimación previa a la generación Esta estimación no es un cargo adicional ni una tarifa fija por la generación completada. |
Ailoot reserva un monto estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →
Las tablas de referencia del modelo no cambian la selección del método, las cotizaciones ni los cargos. Los cargos aplicados usan las tarifas del método Ailoot seleccionado.
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 video | Condiciones de facturaciónNo se declara ninguna condición adicional en esta clave de precios. | Cargo Salida · Precio del video $0.168 por segundo de video Referencia de precio publicada para la configuración mostrada. Los cargos finales corresponden a la configuración realmente facturada. |
| ConfiguraciónPrecio del video | Condiciones de facturaciónconfiguración de audio: with_audio | Cargo Salida · Precio del video $0.252 por segundo de video Referencia de precio publicada para la configuración mostrada. Los cargos finales corresponden a la configuración realmente facturada. |
| ConfiguraciónPrecio del video | Condiciones de facturaciónmodo de generación: text_to_video; resolución: 480p | Cargo Salida · Precio del video $0.168 por segundo de video Referencia de precio publicada para la configuración mostrada. Los cargos finales corresponden a la configuración realmente facturada. |
| ConfiguraciónPrecio del video | Condiciones de facturaciónmodo de generación: text_to_video; resolución: 720p | Cargo Salida · Precio del video $0.168 por segundo de video Referencia de precio publicada para la configuración mostrada. Los cargos finales corresponden a la configuración realmente facturada. |
| ConfiguraciónPrecio del video | Condiciones de facturaciónmodo de generación: image_to_video; resolución: 720p | Cargo Salida · Precio del video $0.168 por segundo de video Referencia de precio publicada para la configuración mostrada. Los cargos finales corresponden a la configuración realmente facturada. |
| ConfiguraciónPrecio del video | Condiciones de facturaciónmodo de generación: text_to_video; resolución: 1080p | Cargo Salida · Precio del video $0.168 por segundo de video Referencia de precio publicada para la configuración mostrada. Los cargos finales corresponden a la configuración realmente facturada. |
| ConfiguraciónPrecio del video | Condiciones de facturaciónmodo de generación: image_to_video; resolución: 1080p | Cargo Salida · Precio del video $0.168 por segundo de video Referencia de precio publicada para la configuración mostrada. Los cargos finales corresponden a 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":"kwaivgi/kling-v3.0-std","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 que te pertenece
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 videos completados o archivos recibidos; descarga cada URL de archivo que se haya devuelto.
Conserva cada salida real que te pertenezca y los metadatos medidos que se devuelvan con ella.
503 result_pending_check + id original + X-Should-Retry:false; nunca repitas el envío original
| Campo | Tipo | Significado |
|---|---|---|
Campoindex | Tipointeger | SignificadoPosición de este video en la lista de salidas, con índice que comienza en cero. |
Campocontent_url | Tipostring | SignificadoURL HTTPS firmada de descarga de este video completado. |
Camposha256 | Tipostring | null | SignificadoResumen SHA-256 de los bytes del video original; null si no está disponible. |
Camposize_bytes | Tipointeger | null | SignificadoTamaño del archivo de video original en bytes; null si no está disponible. |
Campoduration_ms | Tipointeger | null | SignificadoDuración medida del video en milisegundos; null si no está disponible. |
Campowidth | Tipointeger | null | SignificadoAncho del video en píxeles; null si no está disponible. |
Campoheight | Tipointeger | null | SignificadoAlto del video en píxeles; null si no está disponible. |
Campovideo_codec | Tipostring | null | SignificadoIdentificador del códec de video; null si no se registró. |
Campohas_audio | Tipoboolean | null | SignificadoIndica si el video contiene una pista de audio; null si no se midió. |
Campoaudio_codec | Tipostring | null | SignificadoIdentificador del códec de audio; null cuando no se registra ningún identificador. |
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta404 · not_found_error | CondiciónEl acceso al video no está disponible o no se encontró este ID de video. | Siguiente pasoVerifica el acceso al video. Para un video existente, usa su ID público original y la misma clave API. |
Respuesta401 · authentication_error | CondiciónLa clave API no coincide con la cuenta autenticada. | Siguiente pasoRevisa tu clave API y el acceso de tu cuenta antes de enviar. |
Respuesta400 · invalid_request_error | CondiciónNo se pudo leer la solicitud o el índice de descarga no es válido. | Siguiente pasoCorrige el cuerpo de la solicitud. Para una descarga, elige un índice de salida devuelto por la tarea original. |
Respuesta422 · price_unavailable | CondiciónNo se puede cotizar la configuración de video seleccionada. | Siguiente pasoElige una configuración de video compatible y completa sus opciones obligatorias antes de enviar una solicitud corregida. |
Respuesta422 · invalid_request_error | CondiciónUna entrada de video o la tarea original de continuación no es válida. | Siguiente pasoUsa entradas HTTPS válidas. Para una continuación, usa el ID público de tu video original completado con la misma clave API. |
Respuesta402 · billing_error | CondiciónEl saldo disponible o los límites no permiten reservar fondos. | Siguiente pasoRevisa tu saldo disponible y tus límites antes de enviar una solicitud nueva. |
Respuesta503 · server_error | CondiciónLa verificación del video, el almacenamiento o el acceso al servicio no están disponibles temporalmente. | Siguiente pasoEspera a que el servicio esté disponible. Si ya tienes un ID de video, consulta esa tarea original en lugar de crear otra generación. |
Respuesta503 · result_pending_check | CondiciónEl resultado y el cargo del video original requieren verificación. | Siguiente pasoConserva el ID de video devuelto y consulta esa tarea. No envíes una solicitud de generación de reemplazo mientras se verifica. |
Respuesta503 · owned_result_unavailable | CondiciónLa descarga del video existente no está disponible temporalmente. | Siguiente pasoConsulta más tarde la misma tarea de video y descarga su salida existente. Una generación nueva crea una operación independiente. |
Respuesta409 · video_not_ready | CondiciónEl contenido del video no se ha publicado. | Siguiente pasoConsulta el estado de la tarea original. Descarga cuando indique completed; si indica failed, sigue su aviso de verificación del cargo. |
Ailoot Ultra kwaivgi/kling-v3.0-std
Usa las rutas de método indicadas arriba.