models

Kling: Video O1

Markdown · JSON

Kling: Video O1

Kling VIDEO O1 es el modelo de Kuaishou guiado por referencias para generar y editar escenas con texto, imágenes, elementos de sujeto y un clip fuente. Usa su perfil de generación de tres a diez segundos para continuidad visual, transiciones de fotogramas guiadas y cambios específicos de material existente.

Sobre el modelo

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 O1 es el modelo unificado de video de Kuaishou guiado por referencias. Combina descripción textual con imágenes, elementos preparados de sujeto o un video fuente para orientar escenas nuevas y cambios específicos. Su interfaz central es un encargo visual: identifica el material de referencia, describe su función e indica apariencia, acción o transformación deseadas.

Una toma nueva puede comenzar con texto, imagen inicial o referencias visuales. Usa una imagen para establecer personaje u objeto y describe entorno, acción y punto de vista con palabras. Si varias referencias aportan rasgos distintos, asigna sus funciones explícitamente. Un encargo original de producto podría tomar el objeto de una imagen y el entorno de otra y describir su movimiento en ese lugar.

La instrucción de O1 puede nombrar imágenes, elementos y videos con marcadores específicos como <<<image_1>>> o <<<video_1>>>. Mantén esos marcadores vinculados al recurso real y explica qué tomar de él. El fabricante permite 2,500 caracteres. Una instrucción breve que identifique sujeto y cambio sirve más que una colección de estilos inconexos.

Para referencias basadas en imagen sin entrada de video, el total documentado es de hasta siete imágenes de referencia y elementos de varias imágenes. Con video de referencia, ese total de imágenes/elementos es cuatro. Estos límites corresponden a elementos basados en imagen; otros tipos tienen reglas de compatibilidad distintas. Elige material que aporte apariencia o información esencial en vez de llenar la capacidad con vistas redundantes.

Las imágenes usan JPG, JPEG o PNG mediante URL accesible o datos de imagen, con hasta 10 MB, dimensiones de al menos 300 píxeles y relación entre 1:2.5 y 2.5:1. Prepara sujetos claros y conserva detalles importantes en el recorte. Si personaje o producto deben seguir reconocibles, indica los rasgos a conservar y revísalos en todo el clip.

Primero y último fotograma condicionan una transición entre límites visuales. El flujo O1 documentado exige un inicio cuando se aporta final y no admite control de inicio/final con más de dos imágenes en el arreglo. Al usar ambos extremos, los elementos adicionales de sujeto no forman parte de esa configuración. Separa una tarea con fotogramas controlados de la edición de un video base.

Un video fuente tiene dos funciones posibles. Como clip base, es el material editado: dirige una adición, eliminación, estilo o composición específica e indica qué conservar. La edición sigue la duración de entrada y no combina esa tarea de video base con extremos controlados ni generación de varias tomas. Como referencia de rasgos, el video aporta contenido, estilo o cámara para una toma nueva.

Las instrucciones con video de referencia también pueden pedir una toma anterior o posterior. Identifica la fuente y describe el evento nuevo, como continuar la acción del sujeto o revelar el entorno. Así la referencia comunica información visual; revisa unión y continuidad del sujeto antes de montar el segmento nuevo con el original.

El perfil de entrada acepta una fuente MP4 o MOV de hasta 200 MB y duración mínima de tres segundos. El perfil detallado especifica dimensiones de 720 a 2160 píxeles, de 24 a 60 fps y relación entre 1:2.5 y 2.5:1. Ese flujo devuelve video de 24 fps. La duración exacta permitida también depende del perfil elegido. La generación nueva de O1 abarca tres a diez segundos, distinta del intervalo posterior de 3.0 Omni.

Los modos O1 ofrecen 720p Standard o 1080p Pro. El encuadre de tomas nuevas admite opciones horizontales, verticales y cuadradas donde el flujo use ese control; una edición de video base sigue el encuadre fuente. El audio fuente puede conservarse o descartarse. El flujo de referencias y edición de O1 debe mantenerse separado del perfil posterior 3.0 Omni de audio nativo y storyboard personalizado.

La generación produce una tarea cuyo resultado completo contiene video y duración real. La documentación de resultados indica que los videos generados se eliminan después de 30 días, así que guarda pronto el clip. Conserva fuentes y encargo junto al resultado y revisa cambio solicitado, uso de referencias y continuidad. En una edición, compara zona afectada y partes que conservar. En una toma nueva guiada por referencias, comprueba que cada recurso aportó la información prevista. Mantén disponible el clip para la edición o secuencia de producción posterior.

Ailoot Ultra · Video POST /v1/videos kwaivgi/kling-video-o1

kwaivgi/kling-video-o1

Kuaishou /kwaivgi/kling-video-o1

Inicio

Kling VIDEO O1 es el modelo de Kuaishou guiado por referencias para generar y editar escenas con texto, imágenes, elementos de sujeto y un clip fuente. Usa su perfil de generación de tres a diez segundos para continuidad visual, transiciones de fotogramas guiadas y cambios específicos de material existente.

Entradas aceptadas
Texto · Imágenes
Resultados
Video

Disponible en Ailoot · entradas y métodos

Ailoot Ultra · Video POST /v1/videos
Entrada
text, image
Salida
video
Formato de salida
bytes MP4 originales; sin normalización ni transcodificación
CampoTipoRequisitoValores y límitesPredeterminado
CampomodelTipostringRequisitoObligatorioValores y límites
kwaivgi/kling-video-o1
Predeterminado—
CampopromptTipostringRequisitoObligatorioValores y límitesPredeterminado—
CampodurationTipointegerRequisitoObligatorioValores y límites
5, 10
Mínimo: 1
Máximo: 600
Predeterminado—
CamporesolutionTipostringRequisitoOpcionalValores y límites
720p
Predeterminado—
Campoaspect_ratioTipostringRequisitoOpcionalValores y límites
16:9, 9:16, 1:1
Predeterminado—
Campogenerate_audioTipobooleanRequisitoOpcionalValores y límites
false, true
Predeterminado—
Campoframe_imagesTipoarrayRequisitoOpcionalValores 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_referencesTipoarrayRequisitoOpcionalValores y límitesPredeterminado—
CamposizeTipostringRequisitoOpcionalValores y límites
1280x720, 720x1280, 720x720
Patrón: ^[1-9][0-9]*x[1-9][0-9]*$
Predeterminado—
Campocallback_urlTipostringRequisitoOpcionalValores y límites
Patrón: ^https://
Predeterminado—
Camposession_idTipostringRequisitoOpcionalValores y límitesPredeterminado—
CampotraceTipoobjectRequisitoOpcionalValores y límitesPredeterminado—
CampouserTipostringRequisitoOpcionalValores y límitesPredeterminado—
Combinaciones de materiales de entrada

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-video-o1

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-video-o1

prompt: Tipo: string · Máximo de bytes UTF-8: 10,000 · Se requiere contenido distinto de espacios en blanco: Sí

Parámetros del método y ciclo de vida
ParámetroContrato
Parámetrocontent_typeContratoapplication/json
ParámetrorequiredContratomodel, prompt, duration
Parámetromaterial_typesContratotext, image
Parámetroadditional_propertiesContratofalse
Parámetrooptional_controlsContratoresolution, 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

Tarifas

Cómo se calcula el cargo definitivo

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.

Modo fast
Sin especificar Cuando se selecciona el modo fast
Modo flex
Sin especificar Cuando se selecciona el modo flex
Esfuerzo máximo de razonamiento
Sin especificar Cuando el esfuerzo máximo de razonamiento usa el ajuste default

Tarifas estimadas para comparar

Precios por configuración

Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.

ConfiguraciónTabla de tarifasCantidad previstaUnidad de facturaciónCondiciones de facturaciónCargo
ConfiguraciónTarifas base por tokenTabla de tarifasTarifa baseCantidad prevista—Unidad de facturación—Condiciones de facturación—Cargo
Entrada · Tokens de entrada · Estimación solo para comparar — / 1K tokens
Salida · Tokens de salida · Estimación solo para comparar — / 1K tokens
Entrada · Lectura de caché · Estimación solo para comparar — / 1K tokens
Entrada · Escritura en caché · Estimación solo para comparar — / 1K tokens
Entrada · Escritura en caché, 1 hora · Estimación solo para comparar — / 1K tokens
ConfiguraciónPrecio del videoTabla de tarifas—Cantidad prevista—Unidad de facturaciónpor segundo de videoCondiciones de facturaciónNo se declara ninguna condición adicional en esta clave de precios.Cargo
Salida · Precio del video · Estimación solo para comparar $0.224 por segundo de video
ConfiguraciónCosto estimado de generaciónTabla de tarifas—Cantidad previstaestimación para una generaciónUnidad de facturación—Condiciones de facturación—Cargo
Salida · Costo estimado de generación · Estimación solo para comparar $1.12 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 →

Detalles de la tarifa de referencia

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.

Referencias de precios por configuración de video

Precios por configuración

ConfiguraciónCondiciones de facturaciónCargo
ConfiguraciónPrecio del videoCondiciones 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.

Solicitudes de ejemplo

Ailoot Ultra · Video

curl · crea un video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":5,"model":"kwaivgi/kling-video-o1","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT

Recibir y guardar resultados

Ailoot Ultra · Video

URL firmadas de contenido que te pertenece

  • GET /v1/videos/{public_id}
  • GET /v1/videos/{public_id}/content
Consultar el estado de la tarea
Obtener el estado de la operación original con GET
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Otras consultas de contenido
Guarda todos los resultados completados que te pertenecen
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    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')
    target=Path('owned-'+label+'.bin')
    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)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Conserva todos los resultados completados

Guarda 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.

Si es necesario revisar la respuesta original

503 result_pending_check + id original + X-Should-Retry:false; nunca repitas el envío original

Campos de respuesta
CampoTipoSignificado
CampoindexTipointegerSignificadoPosición de este video en la lista de salidas, con índice que comienza en cero.
Campocontent_urlTipostringSignificadoURL HTTPS firmada de descarga de este video completado.
Camposha256Tipostring | nullSignificadoResumen SHA-256 de los bytes del video original; null si no está disponible.
Camposize_bytesTipointeger | nullSignificadoTamaño del archivo de video original en bytes; null si no está disponible.
Campoduration_msTipointeger | nullSignificadoDuración medida del video en milisegundos; null si no está disponible.
CampowidthTipointeger | nullSignificadoAncho del video en píxeles; null si no está disponible.
CampoheightTipointeger | nullSignificadoAlto del video en píxeles; null si no está disponible.
Campovideo_codecTipostring | nullSignificadoIdentificador del códec de video; null si no se registró.
Campohas_audioTipoboolean | nullSignificadoIndica si el video contiene una pista de audio; null si no se midió.
Campoaudio_codecTipostring | nullSignificadoIdentificador del códec de audio; null cuando no se registra ningún identificador.
Errores y siguientes pasos
RespuestaCondiciónSiguiente paso
Respuesta404 · not_found_errorCondició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_errorCondició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_errorCondició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_unavailableCondició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_errorCondició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_errorCondició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_errorCondició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_checkCondició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_unavailableCondició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_readyCondició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.

Alias

Alias del modelo

Ailoot Ultra kwaivgi/kling-video-o1

Alias de rutas de métodos

Usa las rutas de método indicadas arriba.

ID de modelo relacionados

kwaivgi/kling-video-o1

FAQ · Kling: Video O1
¿Qué entradas y resultados están disponibles?

POST /v1/videos · kwaivgi/kling-video-o1: text, image → video

¿Qué campos utiliza la solicitud?

POST /v1/videos · kwaivgi/kling-video-o1: model, prompt, duration, resolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user

¿Qué límites se aplican?

POST /v1/videos · kwaivgi/kling-video-o1: duration.minimum: 1; duration.maximum: 600; frame_images.max_items: 2; frame_images.min_items: 1

Más detalles

Conecta Ailoot a Claude Code, OpenCode, Hermes o tu aplicación.

La empresa y su cartera de proyectos

La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes.

Compra tokens con descuento.

Ahorro por suscripción para trabajo habitual. Códigos promocionales: hasta el 50% al comprar tokens.

Suscripción
Elige un plan con descuento para tus peticiones habituales.
Código de hasta el 50%
Introduce el código al comprar. El precio se recalcula según la promoción vigente.
Gasto en el historial
Modelo, tokens e importe quedan guardados por cada petición.

Elegir suscripción · Consultar precios de modelos

Conecta la API al producto que vendes.

SaaS, aplicaciones y bots bajo la oferta y el acuerdo de licencia Ailoot. Solicita una licencia de reventa para redistribuir el acceso.

Aplicación comercial
Integra generación de texto, imágenes, vídeo y sonido en funciones de pago de tu servicio.
Licencia para revendedores
Envía descripción del proyecto y esquema de acceso. Solicita condiciones escritas de uso y reventa.
Documentos en la web
La oferta, el acuerdo de licencia y la política de datos están disponibles antes de conectar.

Solicitar licencia de reventa · Oferta y acuerdo de licencia