Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
character_orientation | No | Which way the character faces: video follows the person in the driving clip, image follows the person in the photo. With image the driving clip may be at most 10 seconds. video · image · Por defecto: video |
image_url | Sí | La imagen de partida. |
keep_original_audio | No | Keep the driving clip's own sound in the result. Por defecto: true |
negative_prompt | No | Lo que no quieres ver. |
prompt | No | Optional notes on the result: the setting, the look, anything the driving clip does not show. |
resolution | No | Tamaño de salida. Más grande es más nítido y cuesta más. 720p · 1080p · Por defecto: 720p |
shot_type | No | How the shots are planned: customize keeps to your inputs, intelligent lets the model plan the shots itself. customize · intelligent · Por defecto: customize |
video_url | Sí | El clip con el que trabajar. |
Precios
Los precios están en créditos, los mismos que usas en la web (1 crédito = 0,01 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.
| Opción | Créditos por segundo | ≈ USD |
|---|---|---|
| resolution 720p | 15,12 | 0,15 US$ |
| resolution 1080p | 20,16 | 0,20 US$ |
Para saber la cifra exacta antes de ejecutar, envía el mismo cuerpo a POST /jobs/quote.
Inicio rápido de la API
Llama a la API de Kling 3.0 en tres pasos
- Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola de la API. Las claves empiezan por sk-popnow- y usan los mismos créditos que el sitio web.
- Envía la solicitud. Haz POST /jobs/createTask con model kling/3.0/character-animation y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
- Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "kling/3.0/character-animation",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"resolution": "720p",
"character_orientation": "video",
"shot_type": "customize"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.
Preguntas sobre la API de Kling 3.0
¿Cuánto cuesta la API de Kling 3.0?
Kling 3.0 cuesta desde 15,12 créditos (0,15 US$) por segundo con Control de movimiento, su tarea más barata. Precios por opción: 720p 15,12 créditos por segundo, 1080p 20,16 créditos por segundo. Los créditos son los mismos que en la web (1 crédito = 0,01 $), las cuentas nuevas reciben 30 créditos gratis y las tareas fallidas se reembolsan.
¿Cuál es el nombre de modelo de Kling 3.0 en la API?
Pon kling/3.0/text-to-video para Crear video; kling/3.0/image-to-video para Imagen a video; kling/3.0/character-animation para Control de movimiento en el campo model de POST /jobs/createTask.
¿shot_type single garantiza una sola toma continua?
No por sí solo. En nuestras pruebas, Kling 3.0 a veces cortó a un segundo ángulo incluso con single seleccionado. Agrega una línea como "one continuous shot, no cuts" al prompt si la toma no debe cortarse; eso lo corrigió en nuestra repetición de la misma escena.
¿Cuánto tarda en generarse un clip?
Kling no es instantáneo: planea unos minutos por clip en lugar de segundos, más para Motion Control y resoluciones más altas. El playground muestra el progreso mientras el trabajo corre.
¿Qué límites tiene la API de Kling 3.0?
Resoluciones: 720p · 1080p; Longitud del prompt (caracteres): 2,500; Subida máxima: 10 MB; Clip de entrada más largo: 30 s. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar Kling 3.0 sin escribir código?
Sí. El Playground ejecuta Kling 3.0 con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.
Todos los modelos de Kling
Kling O3 es el hermano más flexible: hasta siete fotos de referencia en un plano, cortes multiplano automáticos y edición de clips que ya tienes. Kling 3.0 es la opción para un plano único muy cuidado con primer y último fotograma o Motion Control.
- API de Kling 3.0Clips 4K, cortes multitoma y control de movimientoDesde 51 créditos por un clip de 5 segundos
- API de Kling O3Kling todo en uno: crear, animar, referenciar y editar hasta 4KDesde 51 créditos por un clip de 5 segundos
- API de Kling 3.0 TurboKling 3.0 más rápido, con sonido en cada clipDesde 84 créditos por un clip de 5 segundos
- API de Kling Avatar 2.0Un retrato que habla o canta tu audio, hasta 5 minutosDesde 7,68 créditos por segundo
- API de Kling 2.6Clips 1080p con sonido y control de movimiento opcionalesDesde 52 créditos por un clip de 5 segundos
- API de Kling 2.5 TurboClips 1080p con banda sonora en cada tomaDesde 42 créditos por un clip de 5 segundos
- API de Kling 2.1 MasterClips 1080p sin sonido, con control fino del promptDesde 162 créditos por un clip de 5 segundos
- API de Kling 2.1Anima una imagen a 720p o 1080p, con fotograma final opcionalDesde 27 créditos por un clip de 5 segundos

