Documentos do controle de movimento Kling API
Documentos Kling Motion Control API para fluxos de trabalho de imagem e vídeo em movimento
Referência de controle de movimento Kling
Documentos Kling Motion Control API para fluxos de trabalho de imagem e vídeo em movimento
Use este guia para integrar Controle de movimento Kling 2.6 por meio do UlazAI API.
A integração atual usa model_slug="kling_3_0_motion_control" ligado
/api/v1/video-studio/generate/ou o caminho de compatibilidade
/api/v1/generate/video/ com video_model="kling_3_0_motion_control".
Você envia exatamente URL de uma imagem, URL de um vídeo em movimento, um prompt e um modo de qualidade 720p ou 1080p.
Pontos de extremidade principais
/api/v1/video-studio/generate/
/api/v1/video-studio/status/{job_id}/
/api/v1/generate/video/
Suporte atual
1 URL de imagem + 1 URL de vídeo em movimento
Saída 720p ou 1080p
3 a 15 segundos
kling-2-6-motion-control-api-docs, mas o
O slug do modelo atual para integrações ao vivo é kling_3_0_motion_control.
Autenticação
Envie um token de portador ou uma chave API em cada solicitação.
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Solicitação canônica
Este pedido vai para /api/v1/video-studio/generate/.
É o contrato API preferido para novas integrações.
{
"model_slug": "kling_3_0_motion_control",
"prompt": "No distortion, the character's movements are consistent with the video.",
"input_image_urls": ["https://example.com/character.png"],
"input_video_urls": ["https://example.com/motion.mp4"],
"character_orientation": "video",
"quality_mode": "720p",
"duration_seconds": 15
}
Referência de campo
| Campo | Obrigatório | Notas |
|---|---|---|
model_slug |
Sim | Deve ser kling_3_0_motion_control |
prompt |
Sim | Máximo de 2.500 caracteres |
input_image_urls |
Sim | Exatamente um URL de imagem pública |
input_video_urls |
Sim | Exatamente um URL de vídeo público em movimento |
character_orientation |
Não | Usar video para seguir a orientação do clipe de movimento ou image para manter o enquadramento dos caracteres carregados |
quality_mode |
Sim | Usar 720p ou 1080p |
duration_seconds |
Sim | Inteiro de 3 a 15. O preço usa essa duração. |
Solicitação de compatibilidade legada
Este pedido vai para /api/v1/generate/video/.
Use-o se você já integra com o vídeo autenticado mais antigo API.
{
"video_model": "kling_3_0_motion_control",
"prompt": "No distortion, the character's movements are consistent with the video.",
"source_image_urls": ["https://example.com/character.png"],
"video_urls": ["https://example.com/motion.mp4"],
"character_orientation": "video",
"quality_mode": "720p",
"duration_seconds": 15
}
Exemplos de resposta
Resposta de geração canônica
{
"success": true,
"job_ids": ["8990f846-f6f0-4ff1-a298-d0a72d49e7ad"],
"credits_remaining_total": 438
}
Resposta de geração legada
{
"success": true,
"data": {
"generation_id": "7f8cfd64-5b91-4a31-a987-e0ea8fd9d0a1",
"generation_type": "video",
"video_model": "kling30_motion",
"mode": "image-to-video",
"status": "processing",
"credits_used": 300
}
}
Pesquisa de status
GET /api/v1/video-studio/status/{job_id}/
GET /api/v1/generate/{generation_id}/
Preços
O preço do Motion Control é baseado na duração.