Come funziona l’API di PopNow
Cosa puoi creare con l’API, le cinque idee su cui si basa ogni pagina e in che ordine leggerle.
L’API di PopNow permette al tuo software di usare i modelli di immagini, video e audio che conosci da popnow.ai. Stessi modelli, stessi prezzi, stessi crediti: solo chiamati dal codice invece che con un clic nel browser.
Cosa puoi creare
| Risultato | Esempi |
|---|---|
| Immagini | Testo in immagine, modifica con uno o più riferimenti, upscaling, rimozione dello sfondo, separazione in livelli |
| Video | Testo in video, immagine in video, video con primo e ultimo fotogramma, video da riferimento, estensione e montaggio di clip, sincronizzazione labiale, avatar parlanti |
| Audio | Musica, effetti sonori, sintesi vocale, colonna sonora per un video esistente, trascrizione |
L’elenco completo, con l’ID e il prezzo di ogni modello, è in Modelli. L’API copre solo la generazione di immagini, video e audio; i modelli di chat e di testo non ne fanno parte.
Cinque idee che trovi ovunque
ID modello
Tutto ciò che puoi chiamare ha un ID nella forma <maker>/<model>/<task>, per esempio alibaba/wan-3.0/image-to-video o google/nano-banana-2.1/edit. Va nel campo model di ogni richiesta. La modifica delle immagini finisce sempre con /edit. Gli strumenti realizzati da PopNow, come la rimozione dello sfondo, hanno popnow come produttore.
Attività
Una generazione richiede da pochi secondi a diversi minuti, quindi ogni richiesta crea un’attività. Ricevi subito un taskId e leggi il risultato quando è pronto. Un’attività passa da queued a running e poi a uno stato finale: succeeded, failed o expired. Dettagli: Attività.
Crediti
L’API consuma gli stessi crediti del sito. Un credito vale 0,01 $ alla tariffa base. Quando un’attività viene accettata, si trattiene il prezzo più alto che può raggiungere; quando finisce, paghi l’importo reale (mai più della trattenuta) e il resto viene rilasciato. Un’attività fallita non costa nulla. Dettagli: Crediti e fatturazione.
Chiave di idempotenza
Un timeout di rete non ti dice se il server ha ricevuto la richiesta. Invia un header Idempotency-Key con ogni attività che crei: un nuovo tentativo con la stessa chiave restituisce l’attività originale invece di crearne — e addebitarne — una seconda. Dettagli: Idempotenza.
Webhook
Invece di chiedere di continuo lo stato di un’attività, dalle una callBackUrl. Quando l’attività termina, PopNow invia il risultato completo a quell’URL, firmato perché tu possa verificare che arriva da noi. Dettagli: Webhook.
Com’è fatta una richiesta
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" }Tutte le risposte usano lo stesso involucro, { "code", "msg", "data", "request_id" }, dove code: 200 significa successo.
In che ordine leggere
- Avvio rapido — il tuo primo risultato in cinque minuti.
- Autenticazione — come proteggere una chiave e limitare cosa può fare.
- Modelli — scegli un modello e leggine i parametri.
- Attività e Webhook — il ciclo di vita completo.
- Media — invia le tue immagini, i tuoi video e audio.
- Errori e Limiti di frequenza — prima di andare in produzione.
Vuoi provare un modello prima di scrivere codice? Ogni modello ha un Playground nella sua pagina API su popnow.ai, che funziona con il tuo account senza chiave.