Checklist per la produzione

A una demo basta una richiesta. Un prodotto deve reggere timeout, webhook doppi, link scaduti e una chiave trapelata. Passa questa lista prima del lancio.

Chiavi

• La chiave sta nel gestore di segreti del tuo server, mai in un browser o nel pacchetto di un’app.
• Ogni ambiente e ogni servizio ha la propria chiave, così puoi revocarne una sola.
• Le chiavi di produzione sono limitate ai modelli che usi e hanno un tetto giornaliero.
• Sai ruotare una chiave senza interruzioni (Autenticazione).

Creare attività

• Ogni createTask invia un Idempotency-Key ricavato dal tuo ID di lavoro, generato una volta e riusato a ogni nuovo tentativo.
• Si ritentano solo 429, 500, 503 e 50301, con attesa crescente e Retry-After (Errori).
• 400, 40004 e gli altri errori «correggi la richiesta» vengono mostrati o registrati, non ritentati.
• Se mostri i prezzi, chiedi prima un preventivo, passi quoteId ed expectedCredits e gestisci 40901.
• Un saldo basso (40201) arriva a una persona — avviso, email, banner — prima che se ne accorgano gli utenti.

Ricevere i risultati

• Le attività hanno una callBackUrl; il tuo endpoint verifica la firma e rifiuta i timestamp vecchi.
• Il gestore del webhook risponde subito 2xx e fa il lavoro in background.
• Le consegne doppie vengono ignorate tramite request_id.
• Un controllo periodico legge le attività il cui webhook non è mai arrivato.
• Il tuo codice tratta ogni stato diverso da succeeded, failed, expired e canceled come «ancora in corso».

File

• I file finiti vengono copiati nel tuo archivio (o nella libreria di asset) invece di puntare all’URL firmato, che scade dopo circa 20 minuti.
• Salvi i taskId, non i link firmati.
• Il codice di download non invia la chiave API all’URL firmato.
• I file di riferimento sono link HTTPS pubblici al file stesso, caricamenti o asset — non pagine di condivisione.

Costi

• Conosci l’unità di prezzo di ogni modello (per immagine, al secondo, per richiesta) e le impostazioni che la fanno salire.
• Anteprime e test usano la risoluzione più economica e la durata più breve.
• Un tetto di spesa ferma i cicli impazziti prima che svuotino il saldo.
• Controlli credits e settled invece di dare per scontato che sia stata addebitata la stima.

Monitoraggio

• Registri request_id, taskId, code ed errorCode per ogni errore.
• Tieni d’occhio la quota di attività failed per modello; un aumento improvviso di solito indica un cambio di prompt, input o modello.
• Misuri per modello il tempo da createTask al webhook e imposti avvisi sui valori anomali.
• Qualcuno nel team sa dove sono i log e la pagina di utilizzo della console API.

Contenuti

PopNow è un servizio per tutti. I modelli applicano le proprie regole sui contenuti e le richieste che rifiutano falliscono con content_rejected. Se sono i tuoi utenti a scrivere i prompt, spiega nella tua interfaccia perché una richiesta è stata rifiutata, invece di mostrare un errore grezzo, e lascia che la modifichino.