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. |
mask_url | No | Pinta la zona que debe cambiar. |
prompt | No | Optional note on expression or mood, such as calm or cheerful. Identity and setting come from the portrait. |
seed | No | Repite el mismo número para obtener un resultado reproducible. ≥ 0 · ≤ 2147483647 |
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 |
|---|---|---|
| Estándar | 2,7 | 0,027 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 Talking Avatar 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 popnow/talking-avatar-v1/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": "popnow/talking-avatar-v1/talking-avatar",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"audio_url": "https://media.popnow.ai/shortfilm/voices/Aoede-46e4c427.mp3"
}
}'
# 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 Talking Avatar
¿Cuánto cuesta la API de Talking Avatar?
Talking Avatar cuesta 2,7 créditos (0,027 US$) 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 Talking Avatar en la API?
Pon popnow/talking-avatar-v1/talking-avatar para Avatar parlante en el campo model de POST /jobs/createTask.
¿Cuánto puede durar el video?
Lo mismo que el audio: de 3 a 60 segundos. Divide los guiones más largos en varias grabaciones y une los clips después.
¿Hace falta un prompt?
No. El audio guía la boca y la cabeza. Un prompt corto puede orientar un poco la expresión, por ejemplo tranquila o alegre, pero la persona y la escena salen del retrato.
¿Y si en la foto hay varias personas?
Pasa mask_url: una imagen en blanco y negro del mismo tamaño que el retrato, en blanco sobre la persona que debe hablar. Sin máscara, la herramienta elige la cara por su cuenta y puede no ser la que querías.
¿Qué límites tiene la API de Talking Avatar?
Longitud del prompt (caracteres): 1,000; Subida máxima: 90 MB. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar Talking Avatar sin escribir código?
Sí. El Playground ejecuta Talking Avatar con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.
