Kling VIDEO 3.0 Pro es el perfil profesional del modelo VIDEO 3.0 de Kuaishou. Su modo Pro documentado produce video 1080p desde texto o imagen, con clips de tres a quince segundos. La edición 3.0 combina audio nativo, controles de consistencia del sujeto y dirección de varias tomas, ofreciendo una forma clara de especificar apariencia, acción, cobertura de cámara y sonido en una producción corta.
Empieza con la acción principal. En una toma con texto, describe sujeto, entorno, luz y punto de vista que haga legible la acción. Con imagen, deja que la apertura establezca apariencia y composición y usa texto para los cambios temporales. Para un concepto original de producto, una imagen preparada puede mostrarlo sobre una superficie de estudio mientras la instrucción describe revelar lentamente material y forma.
La dirección de varias tomas ofrece cobertura automática o secuencia personalizada. La automática planea cambios de encuadre y ángulo desde el encargo; una escena que quepa en una vista continua puede seguir como toma única. Un storyboard personalizado define contenido y duración por toma. El perfil permite de una a seis tomas, máximo 512 caracteres y mínimo un segundo por toma; sus duraciones deben sumar el total.
Para una narración corta, describe vista de establecimiento, acción principal y detalle final como tomas separadas. Indica tratamiento de cámara y qué debe notar el público en cada una. Mantén consistente la apariencia del sujeto recurrente mientras cambias deliberadamente acción y cobertura. El campo de instrucción única admite hasta 2,500 caracteres; una secuencia personalizada usa descripciones separadas por toma.
Las referencias de sujeto apoyan una escena con imagen cuando personaje, producto o entorno deben seguir reconocibles. Elige vistas claras que comuniquen los rasgos a conservar y nombra consistentemente cada sujeto. El perfil documentado permite hasta tres elementos preparados. Mantén enfocadas sus funciones en vez de combinar recursos que contradigan la apariencia.
Primero y último fotograma dan límites visuales para una transición condicionada por imagen. Prepara fotogramas acordes en sujeto y escena y describe cómo los conecta el movimiento. La entrada compatible usa JPG, JPEG o PNG de hasta 10 MB, dimensiones de al menos 300 píxeles y aspecto inicial entre 1:2.5 y 2.5:1. Una tarea de fotogramas controlados y un storyboard personalizado tienen manejo propio de entrada; organiza el material según el flujo antes de escribir el encargo completo.
El audio nativo puede combinar líneas habladas, atmósfera e interpretación visual. Está apagado por defecto en la referencia y se activa para una escena audiovisual. El perfil 3.0 incluye chino, inglés, japonés, coreano y español, además de cambios de idioma y tratamientos compatibles de dialecto o acento. La guía dice que el diálogo escrito en otro idioma se traduce al inglés. Asigna cada línea al sujeto y distingue diálogo de fondo sonoro para explicar quién habla y qué rodea la acción.
Un encargo original de dos personajes puede identificar Hablante A y Hablante B, dar a cada uno una línea corta y describir la respuesta visible. Ajusta diálogo a duración e identifica al hablante al cambiar la vista. Dirección de voz y referencia de personaje tienen funciones distintas; el encargo debe indicar la interpretación en vez de suponer que una imagen contiene las palabras.
VIDEO 3.0 también mejora el manejo de letras visibles en escenas con imagen. Si importa un letrero, etiqueta o subtítulo, identifícalo y conserva su apariencia de referencia. Revisa ortografía, legibilidad y movimiento, especialmente si lleva un mensaje de producto o campaña. La capacidad de letras orienta la generación, sin sustituir la comprobación visual final.
Pro es 1080p; Standard es 720p. El modo 4K seleccionado por separado es otro perfil, por lo que Pro no equivale a toda resolución superior. Para generación con texto, las relaciones documentadas incluyen 16:9, 9:16 y 1:1. Elige el cuadro según destino y conserva legible la composición.
La generación se ejecuta como tarea cuyo resultado exitoso expone video completado 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. Consérvalo con encargo y referencias y revisa continuidad del sujeto, orden solicitado, cámara, diálogo y letras. Usa el clip seleccionado como concepto cinematográfico, escena de producto o relato breve y revisa específicamente la parte que no logró el resultado.
", "aboutText": "Kling VIDEO 3.0 Pro es el perfil profesional del modelo VIDEO 3.0 de Kuaishou. Su modo Pro documentado produce video 1080p desde texto o imagen, con clips de tres a quince segundos. La edición 3.0 combina audio nativo, controles de consistencia del sujeto y dirección de varias tomas, ofreciendo una forma clara de especificar apariencia, acción, cobertura de cámara y sonido en una producción corta.\n\nEmpieza con la acción principal. En una toma con texto, describe sujeto, entorno, luz y punto de vista que haga legible la acción. Con imagen, deja que la apertura establezca apariencia y composición y usa texto para los cambios temporales. Para un concepto original de producto, una imagen preparada puede mostrarlo sobre una superficie de estudio mientras la instrucción describe revelar lentamente material y forma.\n\nLa dirección de varias tomas ofrece cobertura automática o secuencia personalizada. La automática planea cambios de encuadre y ángulo desde el encargo; una escena que quepa en una vista continua puede seguir como toma única. Un storyboard personalizado define contenido y duración por toma. El perfil permite de una a seis tomas, máximo 512 caracteres y mínimo un segundo por toma; sus duraciones deben sumar el total.\n\nPara una narración corta, describe vista de establecimiento, acción principal y detalle final como tomas separadas. Indica tratamiento de cámara y qué debe notar el público en cada una. Mantén consistente la apariencia del sujeto recurrente mientras cambias deliberadamente acción y cobertura. El campo de instrucción única admite hasta 2,500 caracteres; una secuencia personalizada usa descripciones separadas por toma.\n\nLas referencias de sujeto apoyan una escena con imagen cuando personaje, producto o entorno deben seguir reconocibles. Elige vistas claras que comuniquen los rasgos a conservar y nombra consistentemente cada sujeto. El perfil documentado permite hasta tres elementos preparados. Mantén enfocadas sus funciones en vez de combinar recursos que contradigan la apariencia.\n\nPrimero y último fotograma dan límites visuales para una transición condicionada por imagen. Prepara fotogramas acordes en sujeto y escena y describe cómo los conecta el movimiento. La entrada compatible usa JPG, JPEG o PNG de hasta 10 MB, dimensiones de al menos 300 píxeles y aspecto inicial entre 1:2.5 y 2.5:1. Una tarea de fotogramas controlados y un storyboard personalizado tienen manejo propio de entrada; organiza el material según el flujo antes de escribir el encargo completo.\n\nEl audio nativo puede combinar líneas habladas, atmósfera e interpretación visual. Está apagado por defecto en la referencia y se activa para una escena audiovisual. El perfil 3.0 incluye chino, inglés, japonés, coreano y español, además de cambios de idioma y tratamientos compatibles de dialecto o acento. La guía dice que el diálogo escrito en otro idioma se traduce al inglés. Asigna cada línea al sujeto y distingue diálogo de fondo sonoro para explicar quién habla y qué rodea la acción.\n\nUn encargo original de dos personajes puede identificar Hablante A y Hablante B, dar a cada uno una línea corta y describir la respuesta visible. Ajusta diálogo a duración e identifica al hablante al cambiar la vista. Dirección de voz y referencia de personaje tienen funciones distintas; el encargo debe indicar la interpretación en vez de suponer que una imagen contiene las palabras.\n\nVIDEO 3.0 también mejora el manejo de letras visibles en escenas con imagen. Si importa un letrero, etiqueta o subtítulo, identifícalo y conserva su apariencia de referencia. Revisa ortografía, legibilidad y movimiento, especialmente si lleva un mensaje de producto o campaña. La capacidad de letras orienta la generación, sin sustituir la comprobación visual final.\n\nPro es 1080p; Standard es 720p. El modo 4K seleccionado por separado es otro perfil, por lo que Pro no equivale a toda resolución superior. Para generación con texto, las relaciones documentadas incluyen 16:9, 9:16 y 1:1. Elige el cuadro según destino y conserva legible la composición.\n\nLa generación se ejecuta como tarea cuyo resultado exitoso expone video completado 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. Consérvalo con encargo y referencias y revisa continuidad del sujeto, orden solicitado, cámara, diálogo y letras. Usa el clip seleccionado como concepto cinematográfico, escena de producto o relato breve y revisa específicamente la parte que no logró el resultado.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "c934e2f8ea0938c9d04def041db51c2ef8bf31570291d4c6419b5ae6dd42660a", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "es-mx", "methods": [ { "html": "kwaivgi/kling-v3.0-proKling VIDEO 3.0 Pro es el perfil profesional de video 1080p de Kuaishou para escenas guiadas por texto e imagen. Combina clips de tres a quince segundos, audio nativo, fotogramas límite guiados y dirección de una o varias tomas para conceptos cinematográficos y producciones cortas.
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 Pro es el perfil profesional del modelo VIDEO 3.0 de Kuaishou. Su modo Pro documentado produce video 1080p desde texto o imagen, con clips de tres a quince segundos. La edición 3.0 combina audio nativo, controles de consistencia del sujeto y dirección de varias tomas, ofreciendo una forma clara de especificar apariencia, acción, cobertura de cámara y sonido en una producción corta.
Empieza con la acción principal. En una toma con texto, describe sujeto, entorno, luz y punto de vista que haga legible la acción. Con imagen, deja que la apertura establezca apariencia y composición y usa texto para los cambios temporales. Para un concepto original de producto, una imagen preparada puede mostrarlo sobre una superficie de estudio mientras la instrucción describe revelar lentamente material y forma.
La dirección de varias tomas ofrece cobertura automática o secuencia personalizada. La automática planea cambios de encuadre y ángulo desde el encargo; una escena que quepa en una vista continua puede seguir como toma única. Un storyboard personalizado define contenido y duración por toma. El perfil permite de una a seis tomas, máximo 512 caracteres y mínimo un segundo por toma; sus duraciones deben sumar el total.
Para una narración corta, describe vista de establecimiento, acción principal y detalle final como tomas separadas. Indica tratamiento de cámara y qué debe notar el público en cada una. Mantén consistente la apariencia del sujeto recurrente mientras cambias deliberadamente acción y cobertura. El campo de instrucción única admite hasta 2,500 caracteres; una secuencia personalizada usa descripciones separadas por toma.
Las referencias de sujeto apoyan una escena con imagen cuando personaje, producto o entorno deben seguir reconocibles. Elige vistas claras que comuniquen los rasgos a conservar y nombra consistentemente cada sujeto. El perfil documentado permite hasta tres elementos preparados. Mantén enfocadas sus funciones en vez de combinar recursos que contradigan la apariencia.
Primero y último fotograma dan límites visuales para una transición condicionada por imagen. Prepara fotogramas acordes en sujeto y escena y describe cómo los conecta el movimiento. La entrada compatible usa JPG, JPEG o PNG de hasta 10 MB, dimensiones de al menos 300 píxeles y aspecto inicial entre 1:2.5 y 2.5:1. Una tarea de fotogramas controlados y un storyboard personalizado tienen manejo propio de entrada; organiza el material según el flujo antes de escribir el encargo completo.
El audio nativo puede combinar líneas habladas, atmósfera e interpretación visual. Está apagado por defecto en la referencia y se activa para una escena audiovisual. El perfil 3.0 incluye chino, inglés, japonés, coreano y español, además de cambios de idioma y tratamientos compatibles de dialecto o acento. La guía dice que el diálogo escrito en otro idioma se traduce al inglés. Asigna cada línea al sujeto y distingue diálogo de fondo sonoro para explicar quién habla y qué rodea la acción.
Un encargo original de dos personajes puede identificar Hablante A y Hablante B, dar a cada uno una línea corta y describir la respuesta visible. Ajusta diálogo a duración e identifica al hablante al cambiar la vista. Dirección de voz y referencia de personaje tienen funciones distintas; el encargo debe indicar la interpretación en vez de suponer que una imagen contiene las palabras.
VIDEO 3.0 también mejora el manejo de letras visibles en escenas con imagen. Si importa un letrero, etiqueta o subtítulo, identifícalo y conserva su apariencia de referencia. Revisa ortografía, legibilidad y movimiento, especialmente si lleva un mensaje de producto o campaña. La capacidad de letras orienta la generación, sin sustituir la comprobación visual final.
Pro es 1080p; Standard es 720p. El modo 4K seleccionado por separado es otro perfil, por lo que Pro no equivale a toda resolución superior. Para generación con texto, las relaciones documentadas incluyen 16:9, 9:16 y 1:1. Elige el cuadro según destino y conserva legible la composición.
La generación se ejecuta como tarea cuyo resultado exitoso expone video completado 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. Consérvalo con encargo y referencias y revisa continuidad del sujeto, orden solicitado, cámara, diálogo y letras. Usa el clip seleccionado como concepto cinematográfico, escena de producto o relato breve y revisa específicamente la parte que no logró el resultado.
POST /v1/videostext, imagevideo| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites kwaivgi/kling-v3.0-pro | 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-pro
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-pro
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.224 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.336 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.224 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.224 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.224 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.224 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.224 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.672 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.224 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.336 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.224 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.224 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.224 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.224 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.224 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-pro","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-pro
Usa las rutas de método indicadas arriba.