Skip to main content
POST
cURL
Use este endpoint para criar uma tarefa Kling de texto para vídeo a partir de um prompt. Ele inicia um trabalho assíncrono em vez de retornar um vídeo finalizado imediatamente.

Primeira solicitação funcional

  • Envie primeiro um prompt curto
  • Comece com o exemplo kling-v3 e, em seguida, escolha outro model_name do enum do OpenAPI quando precisar de uma faixa de modelo diferente
  • Adicione aspect_ratio, duration, mode ou sound somente depois que o fluxo básico estiver funcionando
  • Defina callback_url se quiser entrega por push em vez de polling puro
  • Use sound: off quando 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

Este endpoint não expõe um token de resolução separado nem um campo size exato. A proporção solicitada controla o formato do quadro de saída.

Fluxo da tarefa

1

Enviar a solicitação de geração

Crie a tarefa por meio deste endpoint e salve o id da tarefa Kling retornado.
2

Consultar o estado da tarefa

Verifique o progresso por meio de Obter uma tarefa Kling até que a tarefa alcance um estado terminal.
3

Persistir o resultado

Quando o Kling retornar os metadados do recurso finalizado, mova o resultado para seu próprio armazenamento se precisar de retenção de longo prazo.
Para a matriz completa de parâmetros e os detalhes das faixas de modelo, consulte a documentação oficial do Kling.

Autorizações

Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Cabeçalhos

Content-Type
string

Must be application/json.

Corpo

application/json
prompt
string
obrigatório

Text prompt describing the video to generate. Maximum 500 characters.

negative_prompt
string

Elements to exclude from the video. Maximum 200 characters.

aspect_ratio
enum<string>

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.

Opções disponíveis:
16:9,
9:16,
1:1
callback_url
string

Webhook URL to receive task status updates when the task completes.

model_name
enum<string>
padrão:kling-v1

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.

Opções disponíveis:
kling-v1,
kling-v1-6,
kling-v2-master,
kling-v2-1-master,
kling-v2-5-turbo,
kling-v2-6,
kling-v3
cfg_scale
number

Prompt adherence strength. Higher values follow the prompt more closely. Range: 0–1.

mode
enum<string>
padrão:std

Generation mode. std for standard (faster), pro for professional (higher quality). The default is std.

Opções disponíveis:
std,
pro
duration
string
padrão:5

Output video length in seconds. Use 5 or 10; omit to use 5.

camera_control
object

Camera motion preset or manual configuration. Omit for automatic camera movement.

external_task_id
string

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.

sound
enum<string>

Optional generated-audio switch for models that support video sound. Use on or off, or omit the field for the model default.

Opções disponíveis:
on,
off

Resposta

200 - application/json

Successful Response

code
integer

Error code; specifically define the error code

message
string

error message

request_id
string

Request ID, system-generated, for tracking requests, troubleshooting issues

data
object