Referencia de la API

Todos los endpoints de la API de PopNow en una página, con enlaces al contrato OpenAPI completo.

El contrato completo y legible por máquinas es openapi.yaml (OpenAPI 3.1). Impórtalo en Postman, Insomnia o un generador de código, o dáselo a un agente de IA. Esta página es el mapa a escala humana.

URL base: https://api.popnow.ai/api/v1 (rutas compatibles con OpenAI: https://api.popnow.ai/v1)
Autenticación: Authorization: Bearer sk-popnow-… en cada solicitud
Sobre: { "code", "msg", "data", "request_id" }; code: 200 es éxito
Importes: créditos enteros (credits, maxCredits…), cada uno también como cadena en dólares; 1 crédito = 0,01 USD

Tareas

Método y ruta	Qué hace	Página
`POST /jobs/createTask`	Crea una tarea de generación (`?wait=` opcional, hasta 60 s)	Tareas
`GET /jobs/recordInfo?taskId=`	Lee el estado y el resultado de una tarea	Tareas
`GET /jobs`	Lista las tareas de esta clave	Tareas
`POST /jobs/quote`	Cotiza una solicitud sin ejecutarla	Facturación
`POST /jobs/retry`	Tarea nueva a partir de una fallida o caducada	Tareas
`POST /jobs/purge`	Borra el contenido de una tarea terminada	Tareas

Modelos

Método y ruta	Qué hace	Página
`GET /models`	Todos los modelos disponibles con precios (`?includeSchema=1` para los esquemas de entrada)	Modelos
`GET /models/{model}`	Un modelo, con su esquema de entrada	Modelos

Archivos y recursos

Método y ruta	Qué hace	Página
`POST /common/upload-url`	Ticket para una subida directa	Medios
`POST /files/{fileId}/commit`	Termina una subida y obtén su URI `popnow://`	Medios
`POST /files/import`	Importa un archivo LoRA desde un enlace	Recursos
`POST /common/download-url`	Enlace firmado nuevo al resultado de una tarea	Medios
`GET /assets`, `POST /assets`	Lista o guarda recursos	Recursos
`GET`, `PATCH`, `DELETE /assets/{assetId}`	Lee, renombra o borra un recurso	Recursos
`GET /assets/entities`	Tus personajes	Recursos
`GET /assets/usage`	Plan de almacenamiento y uso	Recursos

Cuenta

Método y ruta	Qué hace	Página
`GET /chat/credit`	Saldo: disponible, retenido, total	Facturación
`GET /usage`	Uso de esta clave por día y por modelo	Facturación

Compatible con OpenAI Videos (`/v1`)

Método y ruta	Qué hace	Página
`POST /v1/videos`	Crea una tarea de video	OpenAI Videos
`GET /v1/videos/{id}`	La lee	OpenAI Videos
`GET /v1/videos/{id}/content`	Redirige al archivo	OpenAI Videos
`GET /v1/models`	Lista de modelos con formato de OpenAI	OpenAI Videos

Cabeceras comunes

Cabecera	Dirección	Significado
`Idempotency-Key`	Solicitud	Hace seguros durante 24 horas los reintentos de una escritura (Idempotencia)
`Accept-Language`	Solicitud	Idioma de los mensajes de error (Errores)
`X-PopNow-Retention`	Solicitud	Acorta la conservación del contenido de una tarea, en segundos
`X-Request-Id`	Respuesta	Igual que `request_id`; díselo a soporte
`X-RateLimit-Limit`, `X-RateLimit-Remaining`, `Retry-After`	Respuesta	Límites de uso (Límites de uso)