Crear una tarea de texto a video de Kling
Genera videos a partir de prompts de texto con Kling mediante CometAPI POST /kling/v1/videos/text2video, luego sigue el estado de la tarea y recupera los resultados por ID de tarea.
Primera solicitud funcional
- Envía primero un prompt corto
- Comienza con el ejemplo
kling-v3, luego elige otromodel_namedel enum de OpenAPI cuando necesites una pista de modelo diferente - Agrega
aspect_ratio,duration,modeosoundsolo después de que el flujo básico funcione - Configura
callback_urlsi quieres entrega push en lugar de depender únicamente del polling - Usa
sound: offcuando quieras una primera solicitud determinista sin audio en los modelos que admiten sonido generado
Nombres de modelos
Usa model IDs normales de modelos de video Kling en este endpoint. Reserva los model IDs de Omni para Omni Video.Duración y relación de aspecto
size exacto. La relación de aspecto solicitada controla la forma del fotograma de salida.
Flujo de la tarea
Enviar la solicitud de generación
Consultar el estado de la tarea
Persistir el resultado
Autorizaciones
Bearer token authentication. Use your CometAPI key.
Encabezados
Must be application/json.
Cuerpo
Text prompt describing the video to generate. Maximum 500 characters.
Elements to exclude from the video. Maximum 200 characters.
Aspect ratio request. Typical rendered sizes are 1280x720 for 16:9, 720x1280 for 9:16, and 960x960 for 1:1. This endpoint does not expose an exact size field.
16:9, 9:16, 1:1 Webhook URL to receive task status updates when the task completes.
Model ID for this text-to-video request. Use an ordinary Kling video model ID; use Omni model IDs only with the Omni Video endpoint.
kling-v1, kling-v1-6, kling-v2-master, kling-v2-1-master, kling-v2-5-turbo, kling-v2-6, kling-v3 Prompt adherence strength. Higher values follow the prompt more closely. Range: 0–1.
Generation mode. std for standard (faster), pro for professional (higher quality). The default is std.
std, pro Output video length in seconds. Use 5 or 10; omit to use 5.
Camera motion preset or manual configuration. Omit for automatic camera movement.
Custom task id for your own tracking. Does not replace the system-generated task id but can be used to query tasks. Must be unique per user.
Optional generated-audio switch for models that support video sound. Use on or off, or omit the field for the model default.
on, off