Skip to main content
POST

Autorización

string
requerido
Todos los endpoints de la API requieren autenticación mediante Bearer TokenObtenga su API Key:Visite la página de gestión de API Keys para obtener su API KeyAñádala al encabezado de la solicitud:

Parámetros de la solicitud

string
requerido
Nombre del modelo de generación de videoModelos soportados:
  • kling-v2-6 - Kling v2.6 (recomendado)
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
requerido
Prompt de texto, máximo 2500 caracteresDescriba escenas, acciones y estilos en detalle para obtener mejores resultadosEjemplo: "A golden cat running on a sunlit meadow, slow motion, cinematic quality"
string
predeterminado:"std"
Modo de generaciónOpciones:
  • std - Modo estándar (720P, solo video silencioso)
  • pro - Modo profesional (1080P, admite generación automática de audio)
Por defecto: std
Limitación del modo estándar: el modo std solo admite video silencioso. El parámetro audio requiere el modo pro.
integer
predeterminado:"5"
Duración del video (segundos)Opciones: 5 o 10Por defecto: 5
string
predeterminado:"16:9"
Proporción de aspecto del videoOpciones:
  • 16:9 - Paisaje
  • 9:16 - Retrato
  • 1:1 - Cuadrado
Por defecto: 16:9
string
Prompt negativo para excluir contenido no deseadoEjemplo: "blurry, low quality, distorted"
array<url>
Array de URLs de imágenes para generación image-to-video
  • Enviar 1 imagen: usada como primer fotograma
  • Enviar 2 imágenes: asignadas automáticamente como primer fotograma + último fotograma (requiere mode: "pro")
Máximo 2 imágenes admitidasEjemplo: ["https://example.com/first.jpg"]
  • Máximo 2 imágenes admitidas
  • El último fotograma (2 imágenes) requiere únicamente el modo pro; el modo std solo admite primer fotograma (1 imagen)
  • El último fotograma y el audio son mutuamente excluyentes: en modo pro, el último fotograma (2 imágenes) y el audio (audio: true) no pueden usarse juntos
  • En modo image-to-video, aspect_ratio puede ser sobrescrito por la proporción real de la imagen
boolean
predeterminado:"false"
Si se debe generar audio automáticamentePor defecto: false
  • Solo disponible en mode: "pro"
  • Mutuamente excluyente con el último fotograma: el audio no puede usarse junto con el último fotograma (2 imágenes)
boolean
Si se debe añadir una marca de agua

Matriz de soporte de funciones

Nota: En modo pro, el control de último fotograma y el de audio son mutuamente excluyentes y no pueden usarse juntos.

Texto a video (Text-to-Video) vs Imagen a video (Image-to-Video)

El sistema determina automáticamente el modo según si se proporciona image_urls: sin imágenes significa text-to-video, con imágenes significa image-to-video.

Respuesta

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

Casos de uso

Caso 1: Texto a video (modo estándar)

Caso 2: Texto a video (modo Pro + prompt negativo)

Caso 3: Imagen a video (primer fotograma)

Caso 4: Imagen a video (control de primer + último fotograma)

Caso 5: Modo Pro + audio automático

Consultar resultados de la tareaLa generación de video es una tarea asíncrona que devuelve un task_id al enviarse. Use el endpoint Obtener estado de la tarea para consultar el progreso y los resultados de la generación.