Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
audio_url | Sí | La voz o la música que se usará. |
image_url | Sí | La imagen de partida. |
prompt | No | Optional direction for the performance: mood, gestures, where the eyes go. |
resolution | No | Tamaño de salida. Más grande es más nítido y cuesta más. 720p · 1080p · Por defecto: 720p |
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 | 7,68 | 0,077 US$ |
| resolution 1080p | 15,36 | 0,15 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 Avatar 2.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/avatar-2.0/talking-avatar 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/avatar-2.0/talking-avatar",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"audio_url": "https://media.popnow.ai/shortfilm/voices/Aoede-46e4c427.mp3",
"resolution": "720p"
}
}'
# 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 Avatar 2.0
¿Cuánto cuesta la API de Kling Avatar 2.0?
Kling Avatar 2.0 cuesta 7,68 créditos (0,077 US$) por segundo. Precios por opción: 720p 7,68 créditos por segundo, 1080p 15,36 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 Avatar 2.0 en la API?
Pon kling/avatar-2.0/talking-avatar para Avatar parlante en el campo model de POST /jobs/createTask.
¿Qué modelo de Kling debería usar en lugar de Avatar 2.0?
Quédate aquí cuando necesites una actuación de retrato fijo: una persona hablando o cantando. Pasa a 2.6 o 3.0 para una escena completa con movimiento de cámara y escenario, ambos también generan su propio sonido.
¿Cuánto tarda en renderizarse un clip?
Por lo general varios minutos, más que los modelos de escena de Kling: es una tarea asíncrona, así que consultas el resultado por sondeo o lo recibes por webhook.
¿Cuánto puede durar el audio, y cómo debería tomar la foto del retrato?
El audio puede durar hasta unos 5 minutos aproximadamente: el clip dura exactamente lo mismo que lo que envías, así que recórtalo primero a la duración que quieras. Para el retrato, usa una foto clara, de frente y bien iluminada; los ángulos laterales o las caras ocultas tienen más probabilidad de desviarse en la sincronía labial y la expresión.
¿Qué límites tiene la API de Kling Avatar 2.0?
Resoluciones: 720p · 1080p; Longitud del prompt (caracteres): 2,500; Subida máxima: 10 MB. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar Kling Avatar 2.0 sin escribir código?
Sí. El Playground ejecuta Kling Avatar 2.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 2.6 hace una escena completa con movimiento de cámara y sonido; Avatar 2.0 es para un retrato fijo que habla o canta.
- 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

