LogoKling 3 API

Documentação Kling 3.0 API

Guia completo para integrar as APIs Kling 3.0 e Kling Video O3 em suas aplicações.

API v1.0 Base URL: https://kling3api.com

Início Rápido

bash
1curl -X POST 'https://kling3api.com/api/generate' \
2 -H 'Authorization: Bearer YOUR_API_KEY' \
3 -H 'Content-Type: application/json' \
4 -d '{
5 "type": "pro-text-to-video",
6 "prompt": "A cinematic shot of mountains at sunrise",
7 "duration": 5,
8 "aspect_ratio": "16:9"
9 }'

Autenticação

Todas as requisições da API requerem autenticação usando um token Bearer no cabeçalho Authorization.

Obtenha sua Chave API: Você pode obter sua chave API na página API Keys no seu painel. → Obtenha sua Chave API

http
1Authorization: Bearer YOUR_API_KEY

Modelos Disponíveis

3.0

Kling 3.0

Geração de vídeo 4K de alta qualidade

TipoDescriçãoDuraçãoCréditos
pro-text-to-videoGeração texto-para-vídeo de qualidade Pro3-15s54/s (no audio) · 80/s (with audio)
pro-image-to-videoAnimação imagem-para-vídeo de qualidade Pro3-15s54/s (no audio) · 80/s (with audio)
std-text-to-videoGeração texto-para-vídeo de qualidade Padrão3-15s40/s (no audio) · 60/s (with audio)
std-image-to-videoGeração imagem-para-vídeo de qualidade Padrão3-15s40/s (no audio) · 60/s (with audio)
O3

Kling Video O3

Próxima geração com referência e edição de vídeo

TipoDescriçãoDuraçãoCréditos
o3-pro-text-to-videoO3 Pro texto-para-vídeo3-15s48/s
o3-pro-image-to-videoO3 Pro imagem-para-vídeo3-15s48/s
o3-pro-reference-to-videoO3 Pro com imagens/vídeo de referência3-15s72/s
o3-pro-video-editO3 Pro edição de vídeoauto435 fixed
o3-std-text-to-videoO3 Standard texto-para-vídeo3-15s36/s
o3-std-image-to-videoO3 Standard imagem-para-vídeo3-15s36/s
o3-std-reference-to-videoO3 Standard referência-para-vídeo3-15s20/s
o3-std-video-editO3 Standard edição de vídeoauto360 fixed

Endpoints da API

POST/api/generate

Criar nova tarefa de geração de vídeo. A API roteia automaticamente para o backend correto baseado no tipo de tarefa.

Corpo da Requisição

Body ParametersJSON
type:string

Tipo de tarefa (ex: pro-text-to-video, o3-pro-reference-to-video)

prompt:string

Descrição textual do vídeo a gerar (máx. 2000 caracteres)

duration:optional number

Duração do vídeo em segundos. Kling 3.0: 3-15. O3: 3-15. Defaults to 5.

aspect_ratio:optional string

Proporção da tela de saída (16:9, 9:16, 1:1) Defaults to 16:9.

image:optional string

URL da imagem para tarefas imagem-para-vídeo

end_image:optional string

URL da imagem do frame final (apenas imagem-para-vídeo)

video:optional string

URL do vídeo para tarefas referência-para-vídeo ou edição-de-vídeo

images:optional string[]

Array de URLs de imagens de referência (O3 referência-para-vídeo, máx. 7)

sound:optional boolean

Habilitar geração de áudio nativo Defaults to true.

negative_prompt:optional string

Prompt negativo para evitar certos elementos

cfg_scale:optional number

Adesão ao prompt (0-1, apenas Kling 3.0) Defaults to 0.5.

Kling 3.0 - Texto para Vídeo

json
1{
2 "type": "pro-text-to-video",
3 "prompt": "A majestic eagle soaring through clouds at sunset",
4 "duration": 5,
5 "aspect_ratio": "16:9",
6 "sound": true
7}

Kling 3.0 - Imagem para Vídeo

json
1{
2 "type": "pro-image-to-video",
3 "prompt": "The character slowly turns and smiles",
4 "image": "https://example.com/my-image.jpg",
5 "duration": 5
6}

Kling O3 - Referência para Vídeo

json
1{
2 "type": "o3-pro-reference-to-video",
3 "prompt": "The character walks through a futuristic city",
4 "images": [
5 "https://example.com/character-reference.jpg",
6 "https://example.com/style-reference.jpg"
7 ],
8 "duration": 5,
9 "aspect_ratio": "16:9"
10}

Kling O3 - Edição de Vídeo

json
1{
2 "type": "o3-pro-video-edit",
3 "prompt": "Change the background to a snowy mountain landscape",
4 "video": "https://example.com/original-video.mp4",
5 "keep_original_sound": true
6}

Respostas

Task created successfully

1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "n75abc123kling3",
6 "status": "IN_PROGRESS",
7 "consumed_credits": 400
8 }
9}
GET/api/status

Verificar o status de uma tarefa de geração de vídeo. Roteamento baseado no prefixo task_id (n75 para Kling 3.0, n71 para Kling O3).

Parâmetros de Consulta

Body ParametersJSON
task_id:string

O ID único da tarefa retornado do endpoint generate (ex: n75xxx para Kling 3.0, n71xxx para O3)

Exemplo de Requisição

bash
1curl -X GET 'https://kling3api.com/api/status?task_id=n75abc123kling3' \
2 -H 'Authorization: Bearer YOUR_API_KEY'

💡 Tip: O campo response na API de status é um array de URLs de vídeo. Você pode acessar diretamente data.response[0] para obter a URL do vídeo.

javascript
1// Extract video URL from response
2const videoUrl = data.response[0];

Respostas

1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "n75abc123kling3",
6 "status": "SUCCESS",
7 "consumed_credits": 400,
8 "created_at": "2026-02-05T10:30:00Z",
9 "request": {
10 "type": "pro-text-to-video",
11 "prompt": "A majestic eagle soaring through clouds at sunset",
12 "duration": 5,
13 "aspect_ratio": "16:9"
14 },
15 "response": [
16 "https://cdn.example.com/videos/abc123.mp4"
17 ],
18 "error_message": null,
19 "type": "pro-text-to-video"
20 }
21}

Playground da API

Teste a API diretamente do seu navegador. Substitua YOUR_API_KEY pela sua chave API real.

Playground da APIPOST

Códigos de Erro

StatusCodeDescription
400 Requisição InválidaINVALID_PROMPTO prompt é inválido ou vazio
400 Requisição InválidaINVALID_DURATIONDuração fora da faixa suportada
400 Requisição InválidaINVALID_TYPETipo de tarefa não suportado
400 Requisição InválidaMISSING_IMAGEImagem é necessária para tarefas imagem-para-vídeo
400 Requisição InválidaMISSING_VIDEOVídeo é necessário para tarefas edição-de-vídeo
401 Não autorizadoINVALID_API_KEYChave API ausente ou inválida
402 INSUFFICIENT_CREDITSCréditos insuficientes para esta operação
429 Muitas RequisiçõesRATE_LIMITEDMuitas requisições, por favor desacelere
500 Erro Interno do ServidorINTERNAL_ERRORErro do servidor, por favor tente novamente mais tarde