Saltar al contenido

Control de movimiento Kling API documentos

Documentos de Kling Motion Control API para flujos de trabajo de imagen y vídeo en movimiento

Referencia de control de movimiento Kling

Documentos de Kling Motion Control API para flujos de trabajo de imagen y vídeo en movimiento

Utilice esta guía para integrar Kling 2.6 Control de movimiento a través del UlazAI API. La integración actual utiliza model_slug="kling_3_0_motion_control" en /api/v1/video-studio/generate/, o la ruta de compatibilidad /api/v1/generate/video/ con video_model="kling_3_0_motion_control". envias exactamente URL de una imagen, URL de un vídeo en movimiento, un prompt y un modo de calidad 720p o 1080p.

Puntos finales principales

/api/v1/video-studio/generate/

/api/v1/video-studio/status/{job_id}/

/api/v1/generate/video/

Soporte actual

1 URL de imagen + 1 URL de vídeo en movimiento

Salida de 720p o 1080p

3 a 15 segundos

Nota de ruta: la URL pública todavía dice kling-2-6-motion-control-api-docs, pero el El modelo actual de slug para integraciones en vivo es kling_3_0_motion_control.
Utilice el punto final de compatibilidad solo si ya realiza envíos con el vídeo autenticado heredado API.

Autenticación

Envíe un token al portador o una clave API en cada solicitud.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Solicitud canónica

Esta solicitud va a /api/v1/video-studio/generate/. Es el contrato API preferido para nuevas integraciones.

{
  "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
}

Referencia de campo

campo Requerido Notas
model_slug si debe ser kling_3_0_motion_control
prompt si Máximo 2500 caracteres
input_image_urls si Exactamente una URL de imagen pública
input_video_urls si Exactamente una URL de vídeo de movimiento público
character_orientation No uso video para seguir la orientación del clip de movimiento o image para mantener el encuadre del personaje subido
quality_mode si uso 720p o 1080p
duration_seconds si Entero de 3 a 15. El precio utiliza esta duración.

Solicitud de compatibilidad heredada

Esta solicitud va a /api/v1/generate/video/. Úselo si ya lo integra con el video autenticado anterior 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
}

Ejemplos de respuesta

Canónica generar respuesta

{
  "success": true,
  "job_ids": ["8990f846-f6f0-4ff1-a298-d0a72d49e7ad"],
  "credits_remaining_total": 438
}

Respuesta de generación heredada

{
  "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
  }
}

Encuesta de estado

GET /api/v1/video-studio/status/{job_id}/
GET /api/v1/generate/{generation_id}/

Precios

El precio de Motion Control se basa en la duración.

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

Créditos, modelos y estado.