Riferimento API
Prima di andare in produzione
Usa questa checklist prima del traffico di produzione. Collega sicurezza delle chiavi, retry, durabilità dei task asincroni, osservabilità e fatturazione in un unico controllo prima del rilascio.
#Checklist per la produzione
Sicurezza
- Tieni le chiavi API su server attendibili; non distribuire mai una chiave permanente in un browser o in un binario mobile.
- Usa una chiave con ambito limitato per ogni progetto e configura limiti di modelli, IP, RPM, RPD e quota.
- Ruota le chiavi senza modificare il codice di integrazione dei modelli.
Affidabilità
- Imposta timeout di connessione e di risposta per ogni richiesta.
- Rispetta Retry-After e usa un backoff esponenziale con jitter.
- Usa Idempotency-Key per gli invii asincroni fatturabili e salva task_id.
Osservabilità
- Registra ID richiesta, modello, endpoint, latenza, stato HTTP e task_id.
- Tieni il contenuto dei prompt fuori dai log, a meno che il debug non sia esplicitamente attivo.
- Collega gli errori visibili ai clienti alla riga corrispondente del registro delle richieste.
Controllo dei costi
- Leggi prezzi e opzioni supportate dai metadati dei modelli in tempo reale.
- Imposta tetti di quota per progetto e ricevi un avviso prima che il portafoglio si esaurisca.
- Riconcilia con il consumo finale a sei decimali nel Registro delle richieste.
#Requisiti per il rilascio
- 1
Prova la richiesta minima
Esegui il modello e l'endpoint esatti nel Workbench, poi copia la richiesta generata.
- 2
Prova i casi di errore
Verifica la gestione di 401, 402, 429, timeout, media non validi e fallimento definitivo dei task.
- 3
Verifica la fatturazione
Abbina una richiesta riuscita al suo consumo a sei decimali e al suo ID richiesta.
- 4
Attiva il monitoraggio
Imposta avvisi su tasso di errore, latenza, task bloccati, errori dei webhook e saldo basso.
#Scorciatoie operative
Non hai ancora risolto?
Inviaci l'ID richiesta o il messaggio di errore e verificheremo.