Kling VIDEO 3.0 Pro es el perfil profesional del modelo VIDEO 3.0 de Kuaishou. Su modo Pro documentado produce vídeo de 1080p a partir de un encargo escrito o una escena basada en imagen, con clips de tres a quince segundos. La edición 3.0 combina audio nativo, controles de coherencia del sujeto y dirección de varios planos, dando a una producción breve una forma clara de especificar aspecto, acción, cobertura de cámara y sonido.
Comience por la acción principal de la escena. En un plano basado en texto, describa el sujeto, el entorno, la luz y el punto de vista que hace legible la acción. En un plano basado en imagen, deje que la imagen inicial establezca el aspecto y la composición y después utilice el texto para lo que cambia en el tiempo. Para un concepto original de producto, una imagen preparada puede mostrar el objeto sobre una superficie de estudio mientras la instrucción describe una revelación lenta de su material y forma.
La dirección de varios planos ofrece cobertura automática o una secuencia personalizada. La generación automática de varios planos planifica cambios de encuadre y ángulo de cámara a partir del encargo; una escena que encaja en una vista continua puede seguir siendo un solo plano. Un guion gráfico personalizado permite definir el contenido y la duración de cada plano. El perfil de planos personalizados del fabricante permite de uno a seis planos, con un máximo de 512 caracteres por plano y un mínimo de un segundo cada uno; sus duraciones deben sumar la duración total del clip.
Para una narración breve, describa una vista de situación, la acción principal y un detalle de conclusión como planos independientes. Indique el tratamiento de cámara y lo que debe percibir el público en cada uno. Mantenga coherente en el encargo el aspecto de un sujeto recurrente y cambie de forma deliberada la acción y la cobertura. El campo de instrucción única de la referencia del fabricante acepta hasta 2500 caracteres; una secuencia personalizada utiliza sus descripciones independientes por plano.
Las referencias de sujeto pueden apoyar una escena basada en imagen cuando el personaje, producto o escenario debe seguir siendo reconocible. Elija vistas claras que comuniquen los rasgos que necesita conservar y nombre de forma coherente cada sujeto de referencia. El perfil documentado basado en imagen permite hasta tres elementos preparados. Mantenga centradas las funciones de las referencias, en lugar de combinar varios recursos con instrucciones contradictorias sobre el aspecto del sujeto.
Los fotogramas inicial y final proporcionan límites visuales para una transición condicionada por imagen. Prepare fotogramas que concuerden en el sujeto y la escena prevista y después describa cómo los conecta el movimiento. La entrada de fotogramas compatible del fabricante utiliza imágenes JPG, JPEG o PNG, con archivos de un máximo de 10 MB, dimensiones de al menos 300 píxeles y relación de aspecto de la imagen inicial entre 1:2.5 y 2.5:1. Una tarea controlada por fotogramas y un guion gráfico personalizado tienen su propio tratamiento de entradas, por lo que debe organizar el material para el flujo seleccionado antes de escribir el encargo completo.
El audio nativo puede combinar frases habladas, ambiente y la interpretación visual. El audio está desactivado de forma predeterminada en la referencia del fabricante y se activa para una escena audiovisual. El perfil de idiomas 3.0 incluye chino, inglés, japonés, coreano y español, además de alternancia de idiomas y tratamientos compatibles de dialecto o acento. La guía del fabricante indica que el diálogo introducido en otro idioma se traduce al inglés. Asigne cada frase al sujeto previsto y distinga el diálogo del sonido de fondo, de modo que el encargo de audio explique quién habla y qué rodea a la acción.
Un encargo original de dos personajes puede identificar al Hablante A y al Hablante B, dar a cada uno una frase breve y describir la respuesta visible entre ellos. Mantenga el diálogo proporcionado a la duración del clip e identifique al hablante cuando cambie la vista. La dirección de voz y una referencia de personaje sirven para fines diferentes; el encargo debe indicar la interpretación prevista, en lugar de asumir que una imagen de referencia contiene las palabras que deben pronunciarse.
VIDEO 3.0 también mejora el tratamiento de letras visibles en una escena basada en imagen. Si importan un cartel, una etiqueta o un rótulo, identifíquelos en el encargo y conserve su aspecto de referencia. Revise el clip completado para comprobar la ortografía, la legibilidad y el movimiento de esas letras, especialmente cuando transmitan un mensaje de producto o campaña. La función de letras del modelo orienta la generación, en lugar de sustituir una comprobación visual final.
El perfil Pro es de 1080p; el Standard es de 720p. El modo 4K del fabricante seleccionado por separado es otro perfil de salida, por lo que Pro no debe tratarse como sinónimo de todos los ajustes de mayor resolución. Para generación basada en texto, las opciones documentadas de encuadre incluyen 16:9, 9:16 y 1:1. Elija el fotograma según la ubicación prevista y mantenga legible la composición dentro de él.
La generación se ejecuta como una tarea cuyo resultado satisfactorio expone el recurso de vídeo completado y la duración real. La documentación de resultados del fabricante indica que los vídeos generados se eliminan después de 30 días, por lo que debe guardar pronto el clip completado. Conserve el vídeo con su encargo y recursos de referencia y después revise la continuidad del sujeto, el orden solicitado de los planos, el movimiento de cámara, el diálogo y las letras. Utilice el clip seleccionado como concepto cinematográfico, escena de producto o narración breve y realice una revisión específica de la parte que no consiguió el resultado previsto.
", "aboutText": "Kling VIDEO 3.0 Pro es el perfil profesional del modelo VIDEO 3.0 de Kuaishou. Su modo Pro documentado produce vídeo de 1080p a partir de un encargo escrito o una escena basada en imagen, con clips de tres a quince segundos. La edición 3.0 combina audio nativo, controles de coherencia del sujeto y dirección de varios planos, dando a una producción breve una forma clara de especificar aspecto, acción, cobertura de cámara y sonido.\n\nComience por la acción principal de la escena. En un plano basado en texto, describa el sujeto, el entorno, la luz y el punto de vista que hace legible la acción. En un plano basado en imagen, deje que la imagen inicial establezca el aspecto y la composición y después utilice el texto para lo que cambia en el tiempo. Para un concepto original de producto, una imagen preparada puede mostrar el objeto sobre una superficie de estudio mientras la instrucción describe una revelación lenta de su material y forma.\n\nLa dirección de varios planos ofrece cobertura automática o una secuencia personalizada. La generación automática de varios planos planifica cambios de encuadre y ángulo de cámara a partir del encargo; una escena que encaja en una vista continua puede seguir siendo un solo plano. Un guion gráfico personalizado permite definir el contenido y la duración de cada plano. El perfil de planos personalizados del fabricante permite de uno a seis planos, con un máximo de 512 caracteres por plano y un mínimo de un segundo cada uno; sus duraciones deben sumar la duración total del clip.\n\nPara una narración breve, describa una vista de situación, la acción principal y un detalle de conclusión como planos independientes. Indique el tratamiento de cámara y lo que debe percibir el público en cada uno. Mantenga coherente en el encargo el aspecto de un sujeto recurrente y cambie de forma deliberada la acción y la cobertura. El campo de instrucción única de la referencia del fabricante acepta hasta 2500 caracteres; una secuencia personalizada utiliza sus descripciones independientes por plano.\n\nLas referencias de sujeto pueden apoyar una escena basada en imagen cuando el personaje, producto o escenario debe seguir siendo reconocible. Elija vistas claras que comuniquen los rasgos que necesita conservar y nombre de forma coherente cada sujeto de referencia. El perfil documentado basado en imagen permite hasta tres elementos preparados. Mantenga centradas las funciones de las referencias, en lugar de combinar varios recursos con instrucciones contradictorias sobre el aspecto del sujeto.\n\nLos fotogramas inicial y final proporcionan límites visuales para una transición condicionada por imagen. Prepare fotogramas que concuerden en el sujeto y la escena prevista y después describa cómo los conecta el movimiento. La entrada de fotogramas compatible del fabricante utiliza imágenes JPG, JPEG o PNG, con archivos de un máximo de 10 MB, dimensiones de al menos 300 píxeles y relación de aspecto de la imagen inicial entre 1:2.5 y 2.5:1. Una tarea controlada por fotogramas y un guion gráfico personalizado tienen su propio tratamiento de entradas, por lo que debe organizar el material para el flujo seleccionado antes de escribir el encargo completo.\n\nEl audio nativo puede combinar frases habladas, ambiente y la interpretación visual. El audio está desactivado de forma predeterminada en la referencia del fabricante y se activa para una escena audiovisual. El perfil de idiomas 3.0 incluye chino, inglés, japonés, coreano y español, además de alternancia de idiomas y tratamientos compatibles de dialecto o acento. La guía del fabricante indica que el diálogo introducido en otro idioma se traduce al inglés. Asigne cada frase al sujeto previsto y distinga el diálogo del sonido de fondo, de modo que el encargo de audio explique quién habla y qué rodea a la acción.\n\nUn encargo original de dos personajes puede identificar al Hablante A y al Hablante B, dar a cada uno una frase breve y describir la respuesta visible entre ellos. Mantenga el diálogo proporcionado a la duración del clip e identifique al hablante cuando cambie la vista. La dirección de voz y una referencia de personaje sirven para fines diferentes; el encargo debe indicar la interpretación prevista, en lugar de asumir que una imagen de referencia contiene las palabras que deben pronunciarse.\n\nVIDEO 3.0 también mejora el tratamiento de letras visibles en una escena basada en imagen. Si importan un cartel, una etiqueta o un rótulo, identifíquelos en el encargo y conserve su aspecto de referencia. Revise el clip completado para comprobar la ortografía, la legibilidad y el movimiento de esas letras, especialmente cuando transmitan un mensaje de producto o campaña. La función de letras del modelo orienta la generación, en lugar de sustituir una comprobación visual final.\n\nEl perfil Pro es de 1080p; el Standard es de 720p. El modo 4K del fabricante seleccionado por separado es otro perfil de salida, por lo que Pro no debe tratarse como sinónimo de todos los ajustes de mayor resolución. Para generación basada en texto, las opciones documentadas de encuadre incluyen 16:9, 9:16 y 1:1. Elija el fotograma según la ubicación prevista y mantenga legible la composición dentro de él.\n\nLa generación se ejecuta como una tarea cuyo resultado satisfactorio expone el recurso de vídeo completado y la duración real. La documentación de resultados del fabricante indica que los vídeos generados se eliminan después de 30 días, por lo que debe guardar pronto el clip completado. Conserve el vídeo con su encargo y recursos de referencia y después revise la continuidad del sujeto, el orden solicitado de los planos, el movimiento de cámara, el diálogo y las letras. Utilice el clip seleccionado como concepto cinematográfico, escena de producto o narración breve y realice una revisión específica de la parte que no consiguió el resultado previsto.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "979cffde5387e3af3734c73a89654925ad054d9b0a82b3372fa5ddb6f443f8e3", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "es", "methods": [ { "html": "kwaivgi/kling-v3.0-proKling VIDEO 3.0 Pro es el perfil profesional de vídeo de 1080p de Kuaishou para escenas basadas en texto e imagen. Combina clips de tres a quince segundos, audio nativo, fotogramas de los extremos guiados y dirección de uno o varios planos para conceptos cinematográficos y producciones breves.
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 vídeo de 1080p a partir de un encargo escrito o una escena basada en imagen, con clips de tres a quince segundos. La edición 3.0 combina audio nativo, controles de coherencia del sujeto y dirección de varios planos, dando a una producción breve una forma clara de especificar aspecto, acción, cobertura de cámara y sonido.
Comience por la acción principal de la escena. En un plano basado en texto, describa el sujeto, el entorno, la luz y el punto de vista que hace legible la acción. En un plano basado en imagen, deje que la imagen inicial establezca el aspecto y la composición y después utilice el texto para lo que cambia en el tiempo. Para un concepto original de producto, una imagen preparada puede mostrar el objeto sobre una superficie de estudio mientras la instrucción describe una revelación lenta de su material y forma.
La dirección de varios planos ofrece cobertura automática o una secuencia personalizada. La generación automática de varios planos planifica cambios de encuadre y ángulo de cámara a partir del encargo; una escena que encaja en una vista continua puede seguir siendo un solo plano. Un guion gráfico personalizado permite definir el contenido y la duración de cada plano. El perfil de planos personalizados del fabricante permite de uno a seis planos, con un máximo de 512 caracteres por plano y un mínimo de un segundo cada uno; sus duraciones deben sumar la duración total del clip.
Para una narración breve, describa una vista de situación, la acción principal y un detalle de conclusión como planos independientes. Indique el tratamiento de cámara y lo que debe percibir el público en cada uno. Mantenga coherente en el encargo el aspecto de un sujeto recurrente y cambie de forma deliberada la acción y la cobertura. El campo de instrucción única de la referencia del fabricante acepta hasta 2500 caracteres; una secuencia personalizada utiliza sus descripciones independientes por plano.
Las referencias de sujeto pueden apoyar una escena basada en imagen cuando el personaje, producto o escenario debe seguir siendo reconocible. Elija vistas claras que comuniquen los rasgos que necesita conservar y nombre de forma coherente cada sujeto de referencia. El perfil documentado basado en imagen permite hasta tres elementos preparados. Mantenga centradas las funciones de las referencias, en lugar de combinar varios recursos con instrucciones contradictorias sobre el aspecto del sujeto.
Los fotogramas inicial y final proporcionan límites visuales para una transición condicionada por imagen. Prepare fotogramas que concuerden en el sujeto y la escena prevista y después describa cómo los conecta el movimiento. La entrada de fotogramas compatible del fabricante utiliza imágenes JPG, JPEG o PNG, con archivos de un máximo de 10 MB, dimensiones de al menos 300 píxeles y relación de aspecto de la imagen inicial entre 1:2.5 y 2.5:1. Una tarea controlada por fotogramas y un guion gráfico personalizado tienen su propio tratamiento de entradas, por lo que debe organizar el material para el flujo seleccionado antes de escribir el encargo completo.
El audio nativo puede combinar frases habladas, ambiente y la interpretación visual. El audio está desactivado de forma predeterminada en la referencia del fabricante y se activa para una escena audiovisual. El perfil de idiomas 3.0 incluye chino, inglés, japonés, coreano y español, además de alternancia de idiomas y tratamientos compatibles de dialecto o acento. La guía del fabricante indica que el diálogo introducido en otro idioma se traduce al inglés. Asigne cada frase al sujeto previsto y distinga el diálogo del sonido de fondo, de modo que el encargo de audio explique quién habla y qué rodea a la acción.
Un encargo original de dos personajes puede identificar al Hablante A y al Hablante B, dar a cada uno una frase breve y describir la respuesta visible entre ellos. Mantenga el diálogo proporcionado a la duración del clip e identifique al hablante cuando cambie la vista. La dirección de voz y una referencia de personaje sirven para fines diferentes; el encargo debe indicar la interpretación prevista, en lugar de asumir que una imagen de referencia contiene las palabras que deben pronunciarse.
VIDEO 3.0 también mejora el tratamiento de letras visibles en una escena basada en imagen. Si importan un cartel, una etiqueta o un rótulo, identifíquelos en el encargo y conserve su aspecto de referencia. Revise el clip completado para comprobar la ortografía, la legibilidad y el movimiento de esas letras, especialmente cuando transmitan un mensaje de producto o campaña. La función de letras del modelo orienta la generación, en lugar de sustituir una comprobación visual final.
El perfil Pro es de 1080p; el Standard es de 720p. El modo 4K del fabricante seleccionado por separado es otro perfil de salida, por lo que Pro no debe tratarse como sinónimo de todos los ajustes de mayor resolución. Para generación basada en texto, las opciones documentadas de encuadre incluyen 16:9, 9:16 y 1:1. Elija el fotograma según la ubicación prevista y mantenga legible la composición dentro de él.
La generación se ejecuta como una tarea cuyo resultado satisfactorio expone el recurso de vídeo completado y la duración real. La documentación de resultados del fabricante indica que los vídeos generados se eliminan después de 30 días, por lo que debe guardar pronto el clip completado. Conserve el vídeo con su encargo y recursos de referencia y después revise la continuidad del sujeto, el orden solicitado de los planos, el movimiento de cámara, el diálogo y las letras. Utilice el clip seleccionado como concepto cinematográfico, escena de producto o narración breve y realice una revisión específica de la parte que no consiguió el resultado previsto.
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. Comprueba has_audio en el resultado para saber si se ha devuelto 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: Lista de objetos de fotograma. Cada objeto contiene type=image_url, image_url con url y frame_type. Usa una URL HTTPS de imagen y establece frame_type en first_frame o last_frame. Cada función de fotograma aparece como máximo una vez. Claves exactas: type, image_url, frame_type Condiciones: Estas claves describen cada objeto de fotograma; image_url solo contiene url. Omite frame_images para una solicitud que solo contenga texto. | Predeterminado— |
Campoinput_references | Tipoarray | RequisitoOpcional | Valores y límites | Predeterminado— |
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 vídeo · Una instrucción escrita. · Obligatorio: model, prompt, duration
Proporciona prompt como texto y duration en segundos enteros. Elige una resolución compatible; añade una relación de aspecto o usa un tamaño enumerado.
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 vídeo · Una instrucción escrita y una imagen del primer fotograma. · Obligatorio: model, prompt, duration, frame_images
frame_images es una lista. Cada objeto de fotograma incluye type, image_url y frame_type; image_url contiene url. Establece type en image_url. Usa first_frame con last_frame opcional. Cada función de fotograma aparece como máximo una vez. Proporciona una URL HTTPS pública de imagen para cada fotograma. Elige una resolución compatible; añade una relación de aspecto o usa un tamaño enumerado.
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 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 | 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 vídeo · 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 vídeo de salida · Estimación solo para comparar $0.224 por segundo de salida |
| ConfiguraciónPrecio del vídeo | Tabla de tarifas— | Cantidad prevista— | Componente del cargo— | Resolución de referencia— | Modo de referencia— | Audio de referencia— | 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.336 por segundo de vídeo |
| ConfiguraciónDe imagen a vídeo (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 vídeo (fotogramas) | Audio de referenciaSin audio | Unidad de facturaciónpor segundo de salida | Condiciones de facturación— | Cargo Salida · Tarifa de referencia por segundo de vídeo de salida · Estimación solo para comparar $0.224 por segundo de salida |
| ConfiguraciónPrecio del vídeo | Tabla de tarifas— | Cantidad prevista— | Componente del cargo— | Resolución de referencia— | Modo de referencia— | Audio de referencia— | Unidad de facturaciónpor segundo de vídeo | Condiciones de facturaciónmodo de generación: image_to_video; resolución: 720p | Cargo Salida · Precio del vídeo · Estimación solo para comparar $0.224 por segundo de vídeo |
| ConfiguraciónDe texto a vídeo · 1080p · tarifa de referencia | Tabla de tarifas— | Cantidad prevista— | Componente del cargoreference_output_rate | Resolución de referencia1080p | Modo de referenciaTexto a vídeo | Audio de referenciaSin audio | Unidad de facturaciónpor segundo de salida | Condiciones de facturación— | Cargo Salida · Tarifa de referencia por segundo de vídeo de salida · Estimación solo para comparar $0.224 por segundo de salida |
| ConfiguraciónDe texto a vídeo · 480p · tarifa de referencia | Tabla de tarifas— | Cantidad prevista— | Componente del cargoreference_output_rate | Resolución de referencia480p | Modo de referenciaTexto a vídeo | Audio de referenciaSin audio | Unidad de facturaciónpor segundo de salida | Condiciones de facturación— | Cargo Salida · Tarifa de referencia por segundo de vídeo de salida · Estimación solo para comparar $0.224 por segundo de salida |
| ConfiguraciónPrecio del vídeo | Tabla de tarifas— | Cantidad prevista— | Componente del cargo— | Resolución de referencia— | Modo de referencia— | Audio de referencia— | Unidad de facturaciónpor segundo de vídeo | Condiciones de facturaciónmodo de generación: text_to_video; resolución: 720p | Cargo Salida · Precio del vídeo · Estimación solo para comparar $0.224 por segundo de vídeo |
| ConfiguraciónCoste 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 · Coste 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 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ónNo se declara ninguna condición adicional en esta clave de precios. | Cargo Salida · Precio del vídeo $0.224 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: with_audio | Cargo Salida · Precio del vídeo $0.336 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ónmodo de generación: text_to_video; resolución: 480p | Cargo Salida · Precio del vídeo $0.224 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ónmodo de generación: text_to_video; resolución: 720p | Cargo Salida · Precio del vídeo $0.224 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ónmodo de generación: image_to_video; resolución: 720p | Cargo Salida · Precio del vídeo $0.224 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ónmodo de generación: text_to_video; resolución: 1080p | Cargo Salida · Precio del vídeo $0.224 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ónmodo de generación: image_to_video; resolución: 1080p | Cargo Salida · Precio del vídeo $0.224 por segundo de vídeo Referencia de precios publicada para la configuración mostrada. Los cargos finales se calculan según la configuración realmente facturada. |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"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 bajo tu titularidad
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\nGuarda todos los vídeos completados o archivos recibidos; descarga cada URL de archivo que se haya devuelto.
Conserva todos los resultados reales bajo tu titularidad y los metadatos medidos que se devuelvan.
503 result_pending_check + originalid + X-Should-Retry:false; no repitas nunca la operación original
| Campo | Tipo | Significado |
|---|---|---|
Campoindex | Tipointeger | SignificadoPosición de este vídeo en la lista de resultados, empezando por cero. |
Campocontent_url | Tipostring | SignificadoURL HTTPS firmada de descarga de este vídeo completado. |
Camposha256 | Tipostring | null | SignificadoHuella SHA-256 de los bytes del vídeo original; null si no está disponible. |
Camposize_bytes | Tipointeger | null | SignificadoTamaño del archivo de vídeo original en bytes; null si no está disponible. |
Campoduration_ms | Tipointeger | null | SignificadoDuración medida del vídeo en milisegundos; null si no está disponible. |
Campowidth | Tipointeger | null | SignificadoAnchura del vídeo en píxeles; null si no está disponible. |
Campoheight | Tipointeger | null | SignificadoAltura del vídeo en píxeles; null si no está disponible. |
Campovideo_codec | Tipostring | null | SignificadoIdentificador del códec de vídeo; null si no se ha registrado. |
Campohas_audio | Tipoboolean | null | SignificadoIndica si el vídeo contiene una pista de audio; null si no se ha medido. |
Campoaudio_codec | Tipostring | null | SignificadoIdentificador del códec de audio; null cuando no se ha registrado ninguno. |
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta404 · not_found_error | CondiciónEl acceso al vídeo no está disponible o no se ha encontrado este ID de vídeo. | Siguiente pasoComprueba el acceso al vídeo. Para un vídeo existente, usa su ID público original y la misma clave API. |
Respuesta401 · authentication_error | CondiciónLa clave API no corresponde a la cuenta autenticada. | Siguiente pasoComprueba tu clave API y el acceso de tu cuenta antes de enviar la solicitud. |
Respuesta400 · invalid_request_error | CondiciónNo se ha podido leer la solicitud o el índice de descarga no es válido. | Siguiente pasoCorrige el cuerpo de la solicitud. Para una descarga, elige un índice de salida devuelto por la tarea original. |
Respuesta422 · price_unavailable | CondiciónNo se puede calcular el precio de la configuración de vídeo seleccionada. | Siguiente pasoElige una configuración de vídeo compatible y completa sus opciones obligatorias antes de enviar una solicitud corregida. |
Respuesta422 · invalid_request_error | CondiciónUna entrada de vídeo o la tarea original de continuación no es válida. | Siguiente pasoUsa entradas HTTPS válidas. Para continuar, usa el ID público de tu vídeo original completado con la misma clave API. |
Respuesta402 · billing_error | CondiciónEl saldo disponible o los límites no permiten efectuar una reserva. | Siguiente pasoComprueba tu saldo disponible y tus límites antes de enviar una nueva solicitud. |
Respuesta503 · server_error | CondiciónLa verificación del vídeo, el almacenamiento o el acceso al servicio no están disponibles temporalmente. | Siguiente pasoEspera a que el servicio esté disponible. Si ya tienes un ID de vídeo, comprueba esa tarea original en lugar de crear otra generación. |
Respuesta503 · result_pending_check | CondiciónEs necesario comprobar el resultado del vídeo original y el cargo. | Siguiente pasoConserva el ID de vídeo devuelto y comprueba esa tarea. No envíes una solicitud de generación sustitutiva mientras se esté comprobando. |
Respuesta503 · owned_result_unavailable | CondiciónLa descarga del vídeo existente no está disponible temporalmente. | Siguiente pasoComprueba más tarde la misma tarea de vídeo y descarga su resultado existente. Una nueva generación crea una operación independiente. |
Respuesta409 · video_not_ready | CondiciónEl contenido del vídeo no se ha publicado. | Siguiente pasoComprueba el estado de la tarea original. Descarga cuando indique completed; si indica failed, sigue su aviso de comprobación del cargo. |
Ailoot Ultra kwaivgi/kling-v3.0-pro
Usa las rutas de método indicadas arriba.