O que Geração de Vídeos Kling faz?
Gere vídeos com IA através da API Kuaishou Kling da AceDataCloud.
Configuração: Veja authentication para configurar o token.
Início Rápido
curl -X POST https://api.acedata.cloud/kling/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"action": "text2video", "prompt": "um gato tocando piano em um telhado ao pôr do sol", "model": "kling-v3", "mode": "std", "duration": 5}'
Assíncrono: Veja async task polling. Faça polling via
POST /kling/taskscom{"id": "..."}.
Modelos
| Modelo | Qualidade | Melhor Para |
|---|---|---|
kling-v3 | Mais recente | Melhor qualidade, duração flexível de 3 a 15s, geração de áudio opcional |
kling-v3-omni | Mais recente | Modelo Omni com suporte a áudio, duração flexível de 3 a 15s |
kling-v2-6 | Alta | Saída de alta qualidade com áudio opcional (modo pro) |
kling-v2-5-turbo | Alta + Rápida | Melhor relação velocidade/qualidade |
kling-v2-master | Alta | Saída de alta qualidade |
kling-v2-1-master | Alta | Versão melhorada do v2 |
kling-v1-6 | Melhorada | Qualidade superior à v1 |
kling-v1 | Padrão | Geração básica, menor custo |
kling-video-o1 | Premium | Mais alta qualidade (modelo pensante) |
Modos de Qualidade
| Modo | Velocidade | Custo | Use Para |
|---|---|---|---|
std (Padrão) | Mais lenta | Menor | Rascunho/visualização |
pro (Profissional) | Mais rápida | Maior | Saída final |
4k (4K nativo) | — | Premium | Saída 4K nativa — apenas kling-v3 e kling-v3-omni; incompatível com camera_control |
Fluxos de Trabalho
1. Texto para Vídeo
POST /kling/videos
{
"action": "text2video",
"prompt": "uma cidade futurista com carros voadores",
"model": "kling-v3",
"mode": "std",
"duration": 5,
"aspect_ratio": "16:9"
}
2. Imagem para Vídeo
Anime uma imagem estática. Opcionalmente, especifique um quadro final.
POST /kling/videos
{
"action": "image2video",
"prompt": "a cena ganha vida lentamente com movimento",
"start_image_url": "https://exemplo.com/cena.jpg",
"end_image_url": "https://exemplo.com/cena-final.jpg",
"model": "kling-v3",
"mode": "pro"
}
3. Estender Vídeo
Continue um vídeo existente com segundos adicionais.
POST /kling/videos
{
"action": "extend",
"video_id": "id-do-video-existente",
"prompt": "a câmera recua para revelar a paisagem completa",
"model": "kling-v2-5-turbo"
}
4. Controle de Movimento
Aplique controle preciso de câmera/movimento a partir de uma imagem + vídeo de referência.
POST /kling/motion
{
"image_url": "https://exemplo.com/sujeito.jpg",
"video_url": "https://exemplo.com/referencia-movimento.mp4"
}
5. Sincronização Labial
Crie um vídeo com sincronização labial a partir de um vídeo de origem mais uma faixa de áudio ou texto de entrada.
POST /kling/lip-sync
{
"video_url": "https://exemplo.com/origem.mp4",
"mode": "audio2video",
"audio_url": "https://exemplo.com/narracao.mp3"
}
Parâmetros
| Parâmetro | Valores | Descrição |
|---|---|---|
action | "text2video", "image2video", "extend" | Modo de geração |
model | Veja a tabela de modelos | Modelo a usar |
mode | "std", "pro", "4k" | Modo de qualidade (4k apenas para kling-v3 / kling-v3-omni, incompatível com camera_control) |
duration | 5, 10 (v3/v3-omni: 3–15) | Duração em segundos |
generate_audio | true, false | Gerar áudio com o vídeo (apenas v3, v3-omni, v2-6 pro) |
aspect_ratio | "16:9", "9:16", "1:1" | Proporção de aspecto do vídeo |
cfg_scale | 0–1 | Força de relevância do prompt |
negative_prompt | string | O que evitar no vídeo |
camera_control | objeto | Parâmetros de movimento da câmera |
element_list | array | Sujeitos de referência da biblioteca de elementos (cada item tem element_id). Combinado com video_list, total de imagens de referência + sujeitos ≤ 7 (ou ≤ 4 se um vídeo de referência estiver incluído) |
video_list | array | Vídeo(s) de referência via video_url (MP4/MOV, 3–10s, ≤200MB, máximo 1 vídeo). Cada item tem video_url, refer_type ("feature" ou "base") e keep_original_sound opcional |
callback_url | string | URL de callback assíncrono |
mode (/kling/lip-sync) | "audio2video", "text2video" | Modo de sincronização labial |
video_url (/kling/lip-sync) | URL | URL do vídeo de origem para sincronização labial |
video_id (/kling/lip-sync) | string | ID de vídeo Kling existente para sincronização labial |
audio_url (/kling/lip-sync) | URL | URL da fonte de áudio (para audio2video) |
audio_type (/kling/lip-sync) | "url", "file" | Tipo de entrada de áudio (padrão url) |
audio_file (/kling/lip-sync) | string | Payload do arquivo de áudio quando audio_type=file |
text (/kling/lip-sync) | string | Texto de entrada para sintetizar fala (para text2video) |
voice_id (/kling/lip-sync) | string | ID de voz predefinida usado em text2video |
voice_language (/kling/lip-sync) | "zh", "en" | Idioma TTS para text2video (padrão zh) |
voice_speed (/kling/lip-sync) | number | Velocidade de fala TTS (padrão 1.0) |
Armadilhas
durationsuporta5ou10segundos para a maioria dos modelos;kling-v3ekling-v3-omnisuportam flexíveis3–15segundosmode=4kestá disponível apenas parakling-v3ekling-v3-omnie é incompatível comcamera_controlgenerate_audioativa geração de áudio sincronizada (suportada porkling-v3,kling-v3-omniekling-v2-6no modo pro)end_image_urlé apenas para a açãoimage2video— define o último quadro- Controle de movimento (
/kling/motion) é um endpoint separado da geração de vídeo - Sincronização labial é um endpoint separado (
/kling/lip-sync) e requermode; useaudio_urlparaaudio2videooutext+ campos de voz paratext2video - O modo
procusta aproximadamente 2x o modostd, mas gera mais rápido com melhor qualidade - Estados de tarefa usam
"succeed"(não "succeeded") — verifique esse valor ao fazer polling negative_promptajuda a evitar elementos indesejados (ex.: "borrado, baixa qualidade, texto")