Criar uma tarefa Kling de texto para vídeo
Gere vídeos a partir de prompts de texto com Kling via CometAPI POST /kling/v1/videos/text2video e, em seguida, acompanhe o status da tarefa e recupere os resultados pelo ID da tarefa.
Primeira solicitação funcional
- Envie primeiro um prompt curto
- Comece com o exemplo
kling-v3e, em seguida, escolha outromodel_namedo enum do OpenAPI quando precisar de uma faixa de modelo diferente - Adicione
aspect_ratio,duration,modeousoundsomente depois que o fluxo básico estiver funcionando - Defina
callback_urlse quiser entrega por push em vez de polling puro - Use
sound: offquando quiser uma primeira solicitação determinística sem áudio em modelos que suportam som gerado
Nomenclatura de modelos
Use model IDs comuns de vídeo Kling neste endpoint. Mantenha model IDs Omni para Omni Video.Duração e proporção
size exato. A proporção solicitada controla o formato do quadro de saída.
Fluxo da tarefa
Enviar a solicitação de geração
Consultar o estado da tarefa
Persistir o resultado
Autorizações
Bearer token authentication. Use your CometAPI key.
Cabeçalhos
Must be application/json.
Corpo
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