PopNowDocs API
Riferimento e assistenza
Contenuto principale

Changelog

Modifiche datate all’API di generazione di immagini, video e audio di PopNow AI, al server MCP remoto, ai webhook, ai crediti e a questa documentazione che riguardano gli sviluppatori.

Modifiche che incidono sul codice che hai scritto per PopNow, dalla più recente. Sono elencate anche le aggiunte che non richiedono interventi, così vedi cosa è diventato possibile. Le date sono in UTC.

Nulla di seguito interrompe un’integrazione esistente, a meno che non sia indicato Azione richiesta.

2026-10-23

Azione richiesta: saldo API separato in USD. Le chiamate con chiave API, MCP con chiave API e Playground consumano un saldo API separato in USD, inizialmente di $0. I fondi API e i crediti del sito non si possono trasferire né usare gli uni al posto degli altri. MCP via OAuth continua a usare i crediti del sito. Il prezzo dello stesso modello con le stesse impostazioni resta invariato. Crea le chiavi in Chiavi API; aggiungi fondi e consulta i pagamenti API in Fatturazione API. Usa i campi USD esistenti (costUsd, estimatedCostUsd, maxChargeUsd, availableUsd, heldUsd, totalUsd, totalSpend) per visualizzazione e contabilità. Conferma i preventivi tramite i campi USD esistenti: invia quoteId ed expectedCostUsd: quote.maxChargeUsd con la stessa richiesta prima della scadenza. Vedi Fatturazione API e Saldo API e rimborsi. Le voci precedenti descrivono il comportamento alle rispettive date, compresi il vecchio saldo condiviso in crediti e l’arrotondamento ai crediti interi.

Azione richiesta: approvazione in USD per le ricette salvate. Le esecuzioni di ricette e workflow tramite REST e MCP con chiave API usano ora preventivi in USD: richiedi un preventivo, poi conferma gli stessi input con currency: "USD", max_usd come stringa decimale e quote_id. I vecchi limiti in crediti vengono rifiutati. Leggi e riprendi l’esecuzione con la sua chiave originale. Il nuovo endpoint di ripresa e lo strumento resume_recipe_run consentono di richiedere un preventivo e approvare il budget dell’intera esecuzione, inclusi i fondi già spesi e gli impegni per le attività in corso. Un preventivo con unpriced_steps copre solo i passaggi con un prezzo già calcolato; quelli successivi attendono un nuovo preventivo e la sua approvazione. Le esecuzioni delle ricette tramite MCP via OAuth continuano a usare i crediti del sito. Vedi Ricette e skill salvate.

Modelli di chat nella documentazione. Claude, Gemini, DeepSeek, GLM, Grok e Kimi si possono chiamare con la stessa chiave API tramite OpenAI Chat Completions e Responses (https://api.popnow.ai/v1), Anthropic Messages e Gemini generateContent, con prezzi per token in USD. Modelli di chat riporta gli URL di base, gli esempi SDK, lo streaming, i prezzi per token e come viene addebitata una richiesta; il riferimento API elenca le route, insieme agli endpoint di ricette, skill e agent skill che vi mancavano.

Documentazione più facile da esplorare. La home della documentazione ha ora la stessa barra laterale di ogni altra pagina, la barra laterale è riorganizzata in base a ciò che stai facendo, e ogni pagina è disponibile in tutte le 12 lingue.

2026-10-22

SDK e integrazioni sui registry dei pacchetti. I pacchetti open source ufficiali non devono più essere installati da GitHub:

  • Python: pip install popnow (PyPI). JavaScript e TypeScript: npm install popnow (npm, anche su JSR). CLI: npm install -g @popnow/cli.
  • PHP: composer require popnow/popnow (Packagist). Go: go get github.com/popnow-ai/popnow-go. Novità: un client Java, ai.popnow:popnow-java su Maven Central.
  • ComfyUI: il pacchetto di nodi è popnow-comfyui sul Comfy Registry. Installalo da ComfyUI Manager oppure con comfy node install popnow-comfyui. Il nodo a file singolo funziona ancora; usane uno dei due.
  • n8n: il nodo della community n8n-nodes-popnow è su npm. Su n8n self-hosted, installalo da Settings > Community Nodes. Non è ancora un nodo verificato, quindi n8n Cloud continua a usare il workflow HTTP Request.
  • Inoltre, novità: popnow-proxy (npm install @popnow/proxy) tiene la chiave API sul tuo server quando un’app browser o mobile chiama l’API, e popnow-bot è un bot Telegram e Discord self-hosted. Il bridge MCP stdio si avvia con npx -y @popnow/mcp.

Se in precedenza hai installato da GitHub, puoi passare al pacchetto del registry; gli import restano gli stessi. SDK, CLI e strumenti open source riporta tutti i comandi.

2026-10-21

Esegui le tue ricette, i tuoi workflow e le tue skill salvati. Le ricette salvate in Studio, i workflow salvati dal canvas e le skill Poppie si possono ora elencare ed eseguire dall’API: GET /api/v1/recipes, POST /api/v1/recipes/{id}/run (con maxCredits per limitare il prezzo) e GET /api/v1/recipes/runs/{runId}, più GET /api/v1/skills. MCP ottiene cinque strumenti corrispondenti, list_my_recipes, run_my_recipe, get_recipe_run, list_my_skills e use_my_skill. Tutto resta privato per te e per i tuoi team. Vedi Le tue ricette, workflow e skill; la console per sviluppatori ha una nuova pagina Recipes & skills con l’ID di ogni elemento e il codice pronto all’uso.

2026-10-19

Azione richiesta: 1 credito vale ora 0,001 $, e i prezzi sono più bassi. Un credito valeva 0,01 $; ora ne vale 0,001. Ogni saldo, prezzo e importo in crediti è 10 volte il numero di prima, per lo stesso valore in dollari USA. Allo stesso tempo, i prezzi di ogni modello sono scesi di circa un terzo, quindi la stessa richiesta ora costa meno dollari di prima.

  • Il tuo saldo è stato convertito. Non si è perso nulla: un saldo di 500 crediti (5 $) ora è di 5.000 crediti (5 $). I tetti di spesa delle chiavi mantengono lo stesso valore in dollari e mostrano i nuovi numeri in crediti.
  • Campi API. credits, maxCredits, expectedCredits, estimatedCredits, availableCredits, heldCredits, totalCredits e i prezzi credits in GET /api/v1/models sono tutti nella nuova unità. Le stringhe in dollari USA (cost, maxCharge, estimatedCost, available …) hanno sempre lo stesso significato. Se il tuo codice converte i crediti in dollari dividendo per 100, dividi invece per 1.000; se memorizza soglie o budget in crediti, moltiplicali per 10.
  • Preventivi vecchi. Un quoteId ed expectedCredits anteriori al cambio non corrispondono più. createTask risponde 40901 (prezzo cambiato) e non trattiene nulla; richiedi un nuovo preventivo e mostra il nuovo prezzo.
  • Arrotondamento. Un’attività viene ancora addebitata in crediti interi, arrotondati per eccesso, ma un credito intero ora vale un decimo di centesimo, quindi l’arrotondamento è dieci volte più piccolo.
  • MCP. Le attività fino a 300 crediti partono subito; quelle più grandi attendono ancora il consenso dell’utente. Vedi Usare PopNow in ChatGPT e Claude.
  • Pacchetti di crediti. I pacchetti partono da 9 $ per 9.000 crediti, con crediti bonus su quelli più grandi, e ora puoi acquistare un importo personalizzato da 10 a 2.000 $, a 1.000 crediti per 1 $. Vedi la pagina dei prezzi e Crediti, prezzi e rimborsi.

SDK e strumenti open source. Il codice per sviluppatori di PopNow è ora pubblico su github.com/popnow-ai, con licenza MIT: SDK per Python e JavaScript e TypeScript, una CLI, client per Go e PHP, la guida alla configurazione MCP, le Agent Skills, il file OpenAPI con esempi, e il sorgente dell’add-on Blender, del pacchetto di nodi ComfyUI e del nodo della community n8n.

  • Nessuno di questi è ancora su npm, PyPI, Packagist o il ComfyUI Registry. Installa da GitHub come mostrato nella nuova pagina SDK, CLI e strumenti open source.
  • L’Avvio rapido mostra gli SDK Python e JavaScript accanto agli esempi HTTP semplici, che restano come sono.

2026-10-17

Server MCP remoto. PopNow ora gestisce un server MCP su https://api.popnow.ai/mcp. Chi lo vuole può aggiungerlo a ChatGPT o Claude e creare immagini, video, canzoni e voiceover in chat; gli sviluppatori possono aggiungerlo a Cursor, VS Code, Claude Code o al proprio client MCP. Dodici strumenti, accesso OAuth 2.1 oppure una chiave sk-popnow-, gli stessi crediti e prezzi di ovunque. Le attività fino a 30 crediti (300 dal 2026-10-19) partono subito; quelle più grandi attendono la conferma dell’utente. Vedi Usare PopNow in ChatGPT e Claude.

  • Le connessioni si possono rivedere e rimuovere in Account settings → Devices → Connected AI apps.
  • Le chiamate fatte con una chiave API contano sui tetti di spesa di quella chiave e compaiono nei log della console.
  • Gli effetti video (Zombie Turn, Flying Car e il resto della pagina Effects) sono disponibili alle app di chat tramite apply_effect. Non sono endpoint REST.

Nuova documentazione. Crediti, prezzi e rimborsi, guide di integrazione per n8n, ComfyUI e l’add-on Blender, Ricette e questo changelog. Webhook ha ottenuto una sezione sulla gestione degli endpoint dell’account nella console.

Regole di rimborso dei pacchetti di crediti. Un pacchetto di crediti può essere rimborsato entro 7 giorni dall’acquisto (14 giorni per i consumatori di UE e Regno Unito) se nessuno dei suoi crediti è stato usato; le generazioni fallite continuano a essere rimborsate automaticamente. I crediti premio gratuiti si spendono prima dei crediti dei pacchetti, e i pacchetti dal più vecchio al più recente. Dettagli: Crediti, prezzi e rimborsi.

Pagine di integrazione su popnow.ai. Le pagine n8n, ComfyUI e Ricette mostrano ora output reali accanto al codice che generano.

2026-10-16

L’API PopNow è aperta. Una sola REST API per la generazione di immagini, video e audio su https://api.popnow.ai/api/v1, documentata qui su popnow.ai/docs in 12 lingue, con il file OpenAPI e llms.txt per strumenti e agenti.

  • Le chiavi iniziano con sk-popnow-. Le chiavi create prima del cambio di prefisso continuano a funzionare; non c’è nulla da ruotare.
  • Gli importi sono in crediti (1 credito = 0,01 $ al lancio, 0,001 $ dal 2026-10-19): credits, maxCredits, expectedCredits, availableCredits e gli altri campi in crediti stanno accanto alle stringhe in dollari USA. Usa i campi in crediti.
  • Gli ID dei modelli hanno la forma <maker>/<model>/<task>, per esempio google/nano-banana-2.1/text-to-image. Gli strumenti di PopNow usano popnow come produttore.
  • Riferimenti popnow:// per i file caricati (popnow://f/…) e per gli elementi della libreria asset (popnow://a/…), utilizzabili in qualsiasi campo media. Vedi Media.
  • I modelli di chat e di testo non fanno parte dell’API pubblica. L’API copre la generazione di immagini, video e audio.

Versione 2 del payload dei webhook. I nuovi callback delle attività vengono inviati con X-Webhook-Payload-Version: 2, e il corpo corrisponde a recordInfo. Vedi Webhook.

Console per sviluppatori. Endpoint webhook a livello di account (firme Standard Webhooks, fino a 16 per account, un segreto per endpoint), un registro delle consegne con reinvio manuale, esecuzioni nel Playground nella pagina API di ogni modello, filtri per chiave nei log e un’esportazione CSV dell’utilizzo.

Controllo dei contenuti all’invio. Prompt e immagini di input vengono controllati prima che un’attività venga accettata. Una richiesta rifiutata restituisce 400 con un data.reason, non trattiene nulla e non costa nulla. Le richieste che il modello stesso rifiuta falliscono comunque come content_rejected, senza costi.

Messaggi di errore in cinese. msg ed errorMessage ora seguono Accept-Language anche per zh-CN e zh-TW, oltre alle dieci lingue già supportate. I codici non cambiano. Vedi Errori.

Route compatibili con OpenAI Videos sotto /v1 accettano anche la chiave in un header x-api-key. Vedi Compatibilità OpenAI Videos.

Add-on Blender 0.1.0. Renderizza, anima e applica texture da una scena in clay in Blender 4.2 o successivo con la tua chiave API. Vedi add-on Blender.

2026-10-15

Libreria asset: personaggi. I personaggi (un insieme con nome di immagini di riferimento disposte sul sito) sono salvati nella libreria asset e si leggono con GET /api/v1/assets/entities; ogni immagine ha il proprio URI popnow://a/… per le richieste di generazione. I personaggi si creano e si modificano sul sito; l’API li legge. Vedi Asset.

In questa pagina