Riferimento API

Tutti gli endpoint dell’API di PopNow in una pagina, con i link al contratto OpenAPI completo.

Il contratto completo e leggibile dalle macchine è openapi.yaml (OpenAPI 3.1). Importalo in Postman, Insomnia o in un generatore di codice, oppure passalo a un agente IA. Questa pagina è la mappa a misura d’uomo.

URL di base: https://api.popnow.ai/api/v1 (route compatibili con OpenAI: https://api.popnow.ai/v1)
Autenticazione: Authorization: Bearer sk-popnow-… su ogni richiesta
Involucro: { "code", "msg", "data", "request_id" }; code: 200 significa successo
Importi: crediti interi (credits, maxCredits …), ognuno anche come stringa in dollari USA; 1 credito = 0,01 $

Attività

Metodo e percorso	Cosa fa	Pagina
`POST /jobs/createTask`	Crea un’attività di generazione (`?wait=` facoltativo, fino a 60 s)	Attività
`GET /jobs/recordInfo?taskId=`	Legge stato e risultato di un’attività	Attività
`GET /jobs`	Elenca le attività di questa chiave	Attività
`POST /jobs/quote`	Calcola il prezzo di una richiesta senza eseguirla	Fatturazione
`POST /jobs/retry`	Nuova attività da una fallita o scaduta	Attività
`POST /jobs/purge`	Elimina il contenuto di un’attività conclusa	Attività

Modelli

Metodo e percorso	Cosa fa	Pagina
`GET /models`	Tutti i modelli disponibili con i prezzi (`?includeSchema=1` per gli schemi di input)	Modelli
`GET /models/{model}`	Un modello, con il suo schema di input	Modelli

File e asset

Metodo e percorso	Cosa fa	Pagina
`POST /common/upload-url`	Ticket per un caricamento diretto	Media
`POST /files/{fileId}/commit`	Completa un caricamento e ottieni l’URI `popnow://`	Media
`POST /files/import`	Importa un file LoRA da un link	Asset
`POST /common/download-url`	Nuovo link firmato al risultato di un’attività	Media
`GET /assets`, `POST /assets`	Elenca o salva asset	Asset
`GET`, `PATCH`, `DELETE /assets/{assetId}`	Legge, rinomina o elimina un asset	Asset
`GET /assets/entities`	I tuoi personaggi	Asset
`GET /assets/usage`	Piano di archiviazione e utilizzo	Asset

Account

Metodo e percorso	Cosa fa	Pagina
`GET /chat/credit`	Saldo: disponibile, trattenuto, totale	Fatturazione
`GET /usage`	Utilizzo di questa chiave per giorno e per modello	Fatturazione

Compatibile con OpenAI Videos (`/v1`)

Metodo e percorso	Cosa fa	Pagina
`POST /v1/videos`	Crea un’attività video	OpenAI Videos
`GET /v1/videos/{id}`	La legge	OpenAI Videos
`GET /v1/videos/{id}/content`	Reindirizza al file	OpenAI Videos
`GET /v1/models`	Elenco dei modelli nel formato OpenAI	OpenAI Videos

Header comuni

Header	Direzione	Significato
`Idempotency-Key`	Richiesta	Rende sicuri per 24 ore i nuovi tentativi di una scrittura (Idempotenza)
`Accept-Language`	Richiesta	Lingua dei messaggi di errore (Errori)
`X-PopNow-Retention`	Richiesta	Accorcia la conservazione del contenuto di un’attività, in secondi
`X-Request-Id`	Risposta	Uguale a `request_id`; comunicalo all’assistenza
`X-RateLimit-Limit`, `X-RateLimit-Remaining`, `Retry-After`	Risposta	Limiti di frequenza (Limiti di frequenza)