Skip to main content
POST

Autenticación

string
requerido
Todas las solicitudes requieren autenticación mediante Bearer TokenObtenga su API Key:Visite la página de gestión de API Keys para obtener su API KeyAñada el siguiente encabezado a cada solicitud:

Parámetros de la solicitud

string
requerido
Nombre del modelo: kling-v3-motion-control o kling-v2-6-motion-control
boolean
predeterminado:"false"
Indica si se debe moderar el contenido antes de enviar la tarea de vídeo.
  • true: revisar los prompts y las imágenes de entrada con omni-moderation-latest
  • false u omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)
string
Prompt de texto que describe el movimiento deseado, los movimientos de cámara y el estiloOpcional pero recomendado — descripciones más específicas producen resultados más establesEjemplo: "The character dances following the reference video, smooth motion, realistic style"
string
requerido
URL de la imagen de referenciaDebe ser un enlace de acceso público
string
requerido
URL del video de referenciaDebe ser un enlace directo de acceso público; se recomienda mp4/mov, menos de 100MB
El servidor detecta la duración real de video_url. El mínimo es 3 segundos; el máximo se determina mediante character_orientation.
string
predeterminado:"yes"
Define si se conserva la pista de audio original del video de referenciaOpciones:
  • yes: Conservar el audio original (predeterminado)
  • no: No conservar el audio original
string
requerido
Control de la orientación del personajeOpciones:
  • image: Usa la orientación del personaje de la imagen de referencia (duración del video de referencia: 3~10s)
  • video: Usa la orientación del personaje del video de referencia (duración del video de referencia: 3~30s)
string
requerido
Modo de generaciónOpciones:
  • std: Modo estándar (equilibrio entre velocidad y calidad)
  • pro: Modo de alta calidad (mayor latencia)
object
Objeto de control de marca de agua (opcional)

Reglas de duración

La duración facturable se determina por la duración real que el servidor detecta a partir de video_url, no por una estimación realizada en el cliente.

Respuesta

integer
Código de estado de la respuesta, 200 en caso de éxito
array
Array de datos de la respuesta

Ejemplos

Ejemplo 1: orientación por imagen (hasta 10s)

Ejemplo 2: orientación por video (hasta 30s)