Skip to main content
POST

Autenticación

string
requerido
Todas las interfaces requieren autenticación mediante Bearer TokenObtener la API Key:Visita la página de gestión de API Keys para obtener tu API KeyAl usarla, añádela en el encabezado de la solicitud:

Parámetros de solicitud

string
requerido
Nombre del modelo de generación de videoModelos admitidos:
  • kling-3.0-turbo - Kling 3.0 Turbo
string
requerido
Prompt de textoEl límite del proveedor es de 3072 caracteres como máximo; se recomienda no superar los 2500 caracteres.Ejemplo: "Un corgi corriendo por la playa, estilo cinematográfico, luz del atardecer"
string
Admite URL de imagen o Base64.
Límites del proveedor para la imagen del primer fotograma:
  • Formato: .jpg / .jpeg / .png
  • Tamaño: ≤ 50MB
  • Ancho y alto: ≥ 300px
  • Relación de aspecto: 1:2.5 ~ 2.5:1
string
predeterminado:"16:9"
Relación de aspecto del videoValores posibles:
  • 16:9 - Horizontal
  • 9:16 - Vertical
  • 1:1 - Cuadrado
Valor predeterminado: 16:9
Solo tiene efecto en texto a video. En imagen a video este campo no es válido; la relación del video la determina el primer fotograma.
string
predeterminado:"720p"
Definición del videoValores posibles:
  • 720p
  • 1080p
Valor predeterminado: 720p
integer
predeterminado:"5"
Duración del video (segundos)Rango de valores: 3-15 (mínimo 3 segundos, máximo 15 segundos)Valor predeterminado: 5⚠️ Atención: debe introducirse como un número puro (por ejemplo 6), sin comillas, de lo contrario se producirá un error
boolean
Si se añade marca de aguaSolo se envía al proveedor cuando se pasa explícitamente; si no se pasa, no se añade marca de agua.

Texto a video vs imagen a video

El sistema determina automáticamente el modo de generación según se proporcione o no first_frame_image: con imagen de primer fotograma usa imagen a video, sin imagen de primer fotograma usa texto a video; el usuario no necesita declararlo explícitamente.

Respuesta

integer
Código de estado de la respuesta, 200 cuando es exitosa
array
Array de datos devueltos

Casos de uso

Caso 1: Texto a video (1080P)

Caso 2: Texto a video (vertical 720P)

Caso 3: Imagen a video (imagen de primer fotograma)

Caso 4: Imagen a video solo con el primer fotograma (sin prompt)

Caso 5: Múltiples tomas (storyboard) (texto a video)

Consultar el resultado de la tareaLa generación de video es una tarea asíncrona; tras el envío se devuelve un task_id. Usa la interfaz Obtener estado de la tarea para consultar el progreso y el resultado de la generación.