Generación de Videos Kling
Genera videos con IA a través de la API de Kuaishou Kling de AceDataCloud.
Configuración: Consulta autenticación para la configuración del token.
Inicio Rápido
curl -X POST https://api.acedata.cloud/kling/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"action": "text2video", "prompt": "un gato tocando el piano en un tejado al atardecer", "model": "kling-v3", "mode": "std", "duration": 5}'
Async: Consulta sondeo de tareas asíncronas. Sondea vía
POST /kling/taskscon{"id": "..."}.
Modelos
| Modelo | Calidad | Mejor Para |
|---|---|---|
kling-v3 | Última | Mejor calidad, duración flexible 3–15s, generación de audio opcional |
kling-v3-omni | Última | Modelo Omni con soporte de audio, duración flexible 3–15s |
kling-v2-6 | Alta | Salida de alta calidad con audio opcional (modo pro) |
kling-v2-5-turbo | Alta + Rápida | Mejor equilibrio velocidad/calidad |
kling-v2-master | Alta | Salida de alta calidad |
kling-v2-1-master | Alta | v2 mejorado |
kling-v1-6 | Mejorada | Mejor calidad que v1 |
kling-v1 | Estándar | Generación básica, menor costo |
kling-video-o1 | Premium | Máxima calidad (modelo de pensamiento) |
Modos de Calidad
| Modo | Velocidad | Costo | Uso |
|---|---|---|---|
std (Estándar) | Más lenta | Menor | Borrador/vista previa |
pro (Profesional) | Más rápida | Mayor | Salida final |
4k (4K nativo) | — | Premium | Salida 4K nativa — solo kling-v3 y kling-v3-omni; incompatible con camera_control |
Flujos de Trabajo
1. Texto a Video
POST /kling/videos
{
"action": "text2video",
"prompt": "una ciudad futurista con coches voladores",
"model": "kling-v3",
"mode": "std",
"duration": 5,
"aspect_ratio": "16:9"
}
2. Imagen a Video
Anima una imagen estática. Opcionalmente especifica un fotograma final.
POST /kling/videos
{
"action": "image2video",
"prompt": "la escena cobra vida lentamente con movimiento",
"start_image_url": "https://ejemplo.com/escena.jpg",
"end_image_url": "https://ejemplo.com/escena-final.jpg",
"model": "kling-v3",
"mode": "pro"
}
3. Extender Video
Continúa un video existente con segundos adicionales.
POST /kling/videos
{
"action": "extend",
"video_id": "id-de-video-existente",
"prompt": "la cámara retrocede para revelar el paisaje completo",
"model": "kling-v2-5-turbo"
}
4. Control de Movimiento
Aplica control preciso de cámara/movimiento a partir de una imagen + video de referencia.
POST /kling/motion
{
"image_url": "https://ejemplo.com/sujeto.jpg",
"video_url": "https://ejemplo.com/referencia-movimiento.mp4"
}
5. Sincronización de Labios
Crea un video sincronizado de labios a partir de un video fuente más una pista de audio o texto de entrada.
POST /kling/lip-sync
{
"video_url": "https://ejemplo.com/fuente.mp4",
"mode": "audio2video",
"audio_url": "https://ejemplo.com/narracion.mp3"
}
Parámetros
| Parámetro | Valores | Descripción |
|---|---|---|
action | "text2video", "image2video", "extend" | Modo de generación |
model | Ver tabla de modelos | Modelo a usar |
mode | "std", "pro", "4k" | Modo de calidad (4k solo para kling-v3 / kling-v3-omni, incompatible con camera_control) |
duration | 5, 10 (v3/v3-omni: 3–15) | Duración en segundos |
generate_audio | true, false | Generar audio con el video (solo v3, v3-omni, v2-6 pro) |
aspect_ratio | "16:9", "9:16", "1:1" | Relación de aspecto del video |
cfg_scale | 0–1 | Intensidad de relevancia del prompt |
negative_prompt | string | Qué evitar en el video |
camera_control | objeto | Parámetros de movimiento de cámara |
element_list | array | Sujetos de referencia de la biblioteca de elementos (cada elemento tiene element_id). Combinado con video_list, el total de imágenes de referencia + sujetos ≤ 7 (o ≤ 4 si se incluye un video de referencia) |
video_list | array | Video(s) de referencia mediante video_url (MP4/MOV, 3–10s, ≤200MB, máximo 1 video). Cada elemento tiene video_url, refer_type ("feature" o "base"), y opcionalmente keep_original_sound |
callback_url | string | URL de callback asíncrono |
mode (/kling/lip-sync) | "audio2video", "text2video" | Modo de sincronización de labios |
video_url (/kling/lip-sync) | URL | URL del video fuente para sincronización de labios |
video_id (/kling/lip-sync) | string | ID de video Kling existente para sincronización de labios |
audio_url (/kling/lip-sync) | URL | URL de la fuente de audio (para audio2video) |
audio_type (/kling/lip-sync) | "url", "file" | Tipo de entrada de audio (por defecto url) |
audio_file (/kling/lip-sync) | string | Carga útil del archivo de audio cuando audio_type=file |
text (/kling/lip-sync) | string | Texto de entrada para sintetizar voz (para text2video) |
voice_id (/kling/lip-sync) | string | ID de preset de voz usado en text2video |
voice_language (/kling/lip-sync) | "zh", "en" | Idioma de TTS para text2video (por defecto zh) |
voice_speed (/kling/lip-sync) | number | Velocidad de habla TTS (por defecto 1.0) |
Advertencias
durationadmite5o10segundos para la mayoría de modelos;kling-v3ykling-v3-omnisoportan3–15segundos flexiblesmode=4ksolo está disponible parakling-v3ykling-v3-omniy es incompatible concamera_controlgenerate_audiohabilita la generación de audio sincronizado (compatible conkling-v3,kling-v3-omniykling-v2-6en modo pro)end_image_urles solo para la acciónimage2video— define el último fotograma- El control de movimiento (
/kling/motion) es un endpoint separado de la generación de video - La sincronización de labios es un endpoint separado (
/kling/lip-sync) y requieremode; usaaudio_urlparaaudio2videootext+ campos de voz paratext2video - El modo
procuesta aproximadamente 2x el modostdpero genera más rápido y con mejor calidad - Los estados de tarea usan
"succeed"(no "succeeded") — verifica este valor al sondear negative_promptayuda a evitar elementos no deseados (ej., "borroso, baja calidad, texto")