Cómo funciona la API de PopNow
Qué puede crear la API, las cinco ideas en las que se basa cada página y en qué orden leerlas.
La API de PopNow permite que tu propio software use los modelos de imagen, video y audio que ya conoces de popnow.ai. Los mismos modelos, los mismos precios, los mismos créditos: solo que llamados desde código en vez de con clics en el navegador.
Qué puedes crear
| Resultado | Ejemplos |
|---|---|
| Imágenes | Texto a imagen, edición con una o varias referencias, ampliación, quitar el fondo, separar capas |
| Video | Texto a video, imagen a video, video con primer y último fotograma, video de referencia, alargar y editar clips, sincronización labial, avatares que hablan |
| Audio | Música, efectos de sonido, texto a voz, sonido para un video existente, voz a texto |
La lista completa, con el ID y el precio de cada modelo, está en Modelos. La API solo cubre la generación de imagen, video y audio; los modelos de chat y de texto no forman parte de ella.
Cinco ideas que verás en todas partes
ID de modelo
Todo lo que puedes llamar tiene un ID con la forma <maker>/<model>/<task>, por ejemplo alibaba/wan-3.0/image-to-video o google/nano-banana-2.1/edit. Va en el campo model de cada solicitud. La edición de imágenes siempre termina en /edit. Las herramientas hechas por PopNow, como quitar el fondo, usan popnow como creador.
Tarea
Generar lleva de unos segundos a varios minutos, así que cada solicitud crea una tarea. Recibes un taskId al instante y lees el resultado cuando está listo. Una tarea pasa de queued a running y luego a un estado final: succeeded, failed o expired. Detalles: Tareas.
Créditos
La API gasta los mismos créditos que la web. Un crédito equivale a 0,01 USD a la tarifa base. Cuando se acepta una tarea, se retiene su precio máximo posible; cuando termina, pagas el importe real (nunca más que la retención) y el resto se libera. Una tarea que falla no cuesta nada. Detalles: Créditos y facturación.
Clave de idempotencia
Un timeout de red no te dice si el servidor recibió tu solicitud. Envía una cabecera Idempotency-Key con cada tarea que crees y un reintento con la misma clave te devolverá la tarea original en lugar de crear —y cobrar— otra. Detalles: Idempotencia.
Webhook
En lugar de preguntar por una tarea una y otra vez, dale un callBackUrl. Cuando la tarea termina, PopNow envía el resultado completo a esa URL, firmado para que puedas comprobar que viene de nosotros. Detalles: Webhooks.
Cómo es una solicitud
POST https://api.popnow.ai/api/v1/jobs/createTask
Authorization: Bearer sk-popnow-...
Idempotency-Key: 7d0c9a52-...
{ "model": "alibaba/wan-3.0/image-to-video",
"input": { "image_url": "https://…/photo.jpg", "prompt": "The waves roll in slowly" },
"callBackUrl": "https://your-app.example.com/hooks/popnow" }Todas las respuestas usan el mismo sobre, { "code", "msg", "data", "request_id" }, donde code: 200 significa éxito.
Orden de lectura
- Inicio rápido: tu primer resultado en cinco minutos.
- Autenticación: cómo proteger una clave y limitar lo que puede hacer.
- Modelos: elige un modelo y lee sus parámetros.
- Tareas y Webhooks: el ciclo de vida completo.
- Medios: envía tus propias imágenes, videos y audios.
- Errores y Límites de uso: antes de salir a producción.
¿Quieres probar un modelo antes de escribir código? Cada modelo tiene un Playground en su página de API de popnow.ai, que funciona con tu cuenta sin necesidad de clave.