Saltar para o conteúdo

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

Nota de rota: o URL público ainda diz kling-2-6-motion-control-api-docs, mas o O slug do modelo atual para integrações ao vivo é kling_3_0_motion_control.
Use o ponto de extremidade de compatibilidade somente se você já enviar o vídeo autenticado herdado API.

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.

720p
20 créditos / segundo
1080p
27 créditos / segundo

Créditos, modelos e status