kling-v1-6
El perfil kling-v1-6 genera vídeo a partir de una descripción escrita de la escena. Planifica un plano breve con un sujeto, una acción y una dirección de cámara claros, utilizando las opciones documentadas de duración de cinco o diez segundos. La generación es asíncrona: conserva la identidad de la tarea devuelta y recupera el vídeo completado después de que la tarea original termine correctamente.
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.
El selector exacto kling-v1-6 identifica el perfil de texto a vídeo de Kling. Envía JSON a POST /v1/videos/generations con model establecido en kling-v1-6 y la escena escrita en prompt. POST /v1/videos también acepta la misma solicitud de generación. Una solicitud clara describe qué se ve, qué ocurre durante el plano y cómo lo observa la cámara. La solicitud mínima de escena proporciona el selector del modelo y prompt, dejando sin especificar los controles adicionales del plano.
Para un plano de producto, describe el objeto, la superficie, la iluminación y una acción visible, como un giro lento o un cambio de posición de la cámara. Para un concepto de escena, identifica el entorno, el sujeto principal y el movimiento por el encuadre. Mantén la acción legible dentro del clip solicitado. Un prompt podría describir una pequeña barca cruzando un lago en calma, una vista amplia desde la orilla, luz de primera hora de la mañana y una cámara estable que sigue la dirección de la barca.
El límite de prompt es de 500 caracteres. El parámetro opcional negative_prompt puede contener hasta 200 caracteres y describe los elementos no deseados. Las opciones de duration documentadas para este perfil son 5 y 10 segundos. Los valores de mode son std y pro. cfg_scale es un número de 0 a 1; la documentación describe los valores más altos como una mayor fidelidad al texto. Elige controles para el plano exacto y conserva los valores enviados junto con el resultado.
El objeto camera_control documentado enumera los tipos de cámara simple, down_back, forward_up, right_turn_forward y left_turn_forward. Su configuración simple incluye los controles horizontal, vertical, pan, tilt, roll y zoom. El ejemplo mínimo de texto proporciona un punto de partida útil cuando una escena puede describirse sin un objeto independiente de control de cámara. Asigna un propósito claro al movimiento de cámara en el prompt, como revelar el sujeto o seguir su movimiento.
El envío inicia una tarea asíncrona. Conserva el id, la cabecera X-Ailoot-Task-Id y el polling_url devueltos, y utiliza después GET en ese polling_url con la misma clave de API de Ailoot para consultar la tarea original. El estado de la tarea se encuentra en data.task_status: submitted y processing son estados pendientes, succeed indica éxito y failed indica fallo. Por tanto, un acuse de recibo del envío es un resultado intermedio. Cuando termine correctamente, recupera todas las URL de data.task_result.videos[].url; son enlaces a archivos de resultados gestionados por Ailoot. GET /v1/videos/{id}/content recupera la primera salida, y su parámetro de consulta index selecciona una salida devuelta por su índice basado en cero. Conserva la respuesta de estado junto con el clip seleccionado. Si se produce un tiempo de espera agotado o una respuesta result_pending_check, conserva la identidad original devuelta y comprueba esa operación en lugar de volver a enviar el plano.
Revisa el metraje completado durante toda su duración: la acción prevista, el aspecto del sujeto, el encuadre y el movimiento forman parte del encargo del plano. Este perfil exacto proporciona el flujo de trabajo de texto a vídeo descrito aquí. Una tarea devuelta que todavía necesite una comprobación de estado debe seguirse utilizando su identidad original, incluso cuando una solicitud del cliente agote el tiempo de espera; conserva esa información de la tarea antes de considerar una nueva solicitud de generación.
Ailoot Ultra · Video POST /v1/videos kling-v1-6
kling-v1-6Primeros pasos
El perfil kling-v1-6 genera vídeo a partir de una descripción escrita de la escena. Planifica un plano breve con un sujeto, una acción y una dirección de cámara claros, utilizando las opciones documentadas de duración de cinco o diez segundos. La generación es asíncrona: conserva la identidad de la tarea devuelta y recupera el vídeo completado después de que la tarea original termine correctamente.
- Entradas aceptadas
- Texto
- Resultados
- Vídeo
Disponible en Ailoot · entradas y métodos
Ailoot Ultra · Video POST /v1/videos
- Tipos de entrada
text- Tipos de salida
video
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites kling-v1-6 | Predeterminado— |
Campoprompt | Tipostring | RequisitoObligatorio | Valores y límites | Predeterminado— |
Campomode | Tipostring | RequisitoObligatorio | Valores y límites std, pro | Predeterminado— |
Campomodel_name | Tipostring | RequisitoOpcional | Valores y límites kling-v1-6 | Predeterminado— |
Campocfg_scale | Tiponumber | RequisitoOpcional | Valores y límites Mínimo: 0 Máximo: 1 | Predeterminado— |
Campoaspect_ratio | Tipostring | RequisitoOpcional | Valores y límites | Predeterminado— |
Camponegative_prompt | Tipostring | RequisitoOpcional | Valores y límites | Predeterminado— |
Campoduration | Tipointeger | RequisitoOpcional | Valores y límites 5, 10 | Predeterminado— |
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, prompt, mode |
Parámetrooptional | Contratomodel_name, cfg_scale, aspect_ratio, negative_prompt, duration |
Parámetromaterial_types | Contratotext |
Parámetroconditions | Contratomodel selects this model. An omitted model_name uses the selected model; an explicit native model_name override is preserved. |
Alias de método: /v1/videos/generations
Ciclo de vida: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Planes
Cómo se calcula el cargo definitivo
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.
- Modo rápido
- Sin especificar Cuando se selecciona el modo rápido
- Modo flex
- Sin especificar Cuando se selecciona el modo flex
- Esfuerzo máximo de razonamiento
- Sin especificar Cuando el esfuerzo máximo de razonamiento utiliza el ajuste predeterminado (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ón | Tabla de tarifas | Cantidad prevista | Cargo |
|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cantidad prevista— | 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ónEstimated generation cost | Tabla de tarifas— | Cantidad previstaestimación para una generación | Cargo Entrada · Coste estimado de generación · Estimación solo para comparar $6 estimación previa a la generación This estimate is not an additional charge or a fixed rate for the completed generation. |
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 →
Solicitudes de ejemplo
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "kling-v1-6", "prompt": "A happy holiday scene at the beach.", "mode": "pro"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
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
# Submit once. Retain the complete result, original identifiers and every response header.
Recibir y guardar resultados
Ailoot Ultra · Video
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Conserva todos los resultados completados
Guarda todos los vídeos completados o archivos recibidos; descarga cada URL de archivo que se haya devuelto.
Retain the complete response, all actual results, original identifiers, usage and response headers.
Si es necesario revisar la respuesta original
Keep the returned public task or operation id and all headers. Read only the original task; unknown or result_pending_check does not authorize another creation.
Campos de respuesta
| Campo | Tipo |
|---|---|
Campodata.task_result.videos[].url | Tipostring or array, as returned |
Alias
Alias del modelo
Ailoot Ultra kling-v1-6
Alias de rutas de métodos
/v1/videos/generations
ID de modelo relacionados
FAQ · kling-v1-6
- ¿Qué entradas y resultados están disponibles?
POST /v1/videos·kling-v1-6:text→video- ¿Qué campos utiliza la solicitud?
POST /v1/videos·kling-v1-6:model,prompt,mode,model_name,cfg_scale,aspect_ratio,negative_prompt,duration- ¿Qué límites se aplican?
POST /v1/videos·kling-v1-6:cfg_scale.minimum:0;cfg_scale.maximum:1