Autenticazione

L’API di CheaperGen usa chiavi API segrete. Invia la tua chiave come token Bearer nell’intestazione Authorization di ogni richiesta a un endpoint autenticato:

Authorization: Bearer cg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Creare una chiave#

Apri Dashboard → Chiavi API e fai clic su Crea chiave. Assegna un nome che indichi dove viene usata (per esempio production-backend). Le chiavi hanno il formato cg_live_ seguito da 32 caratteri casuali.

La chiave completa viene mostrata una sola volta. Conserviamo solo il suo hash SHA-256, quindi non possiamo visualizzarla di nuovo. Se la perdi, revocala e creane una nuova. La dashboard elenca ogni chiave per prefisso, data di creazione e ultimo utilizzo.

Inviare una richiesta autenticata#

const resp = await fetch("https://cheapergen.com/api/v1/account", {
  headers: { Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}` },
});
console.log(await resp.json());

import os, requests

resp = requests.get(
    "https://cheapergen.com/api/v1/account",
    headers={"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"},
)
print(resp.json())

curl https://cheapergen.com/api/v1/account \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY"

Endpoint pubblici#

Gli endpoint di catalogo e prezzi non richiedono una chiave, quindi puoi chiamarli dal browser o da una fase di build: GET /api/v1/models, GET /api/v1/models/{vendor}/{model} e POST /api/v1/quote/{endpoint}. Tutto il resto — invio, consultazione e annullamento delle generazioni, caricamento di file e gestione dell’account — richiede una chiave. Consulta Riferimento API per l’elenco completo.

Proteggere le chiavi#

• Solo lato server. Non inserire mai una chiave in un’app mobile, in un bundle del browser o in un repository pubblico. Chiunque la possieda può spendere il tuo saldo.
• Usa variabili d'ambiente oppure un gestore di segreti, non il codice sorgente. Gli esempi di questa documentazione leggono CHEAPERGEN_API_KEY.
• Una chiave per ogni ambiente o servizio, così puoi revocare una chiave senza influire sulle altre.
• Ruota la chiave creando una nuova chiave, distribuendola e poi revocando quella precedente. La revoca ha effetto immediato.

Stai sviluppando un'app client?#

Instrada le richieste tramite il tuo backend: il server conserva la chiave, autentica i tuoi utenti e inoltra le richieste di generazione. Usa i webhook per sapere quando un job termina e inviare il risultato ai tuoi utenti.

Errori di autenticazione#

Se la chiave manca, è malformata o revocata, l’endpoint restituisce 401 unauthorized:

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or revoked API key"
  }
}

Le richieste dal nostro sito (Studio e Playground nelle pagine dei modelli) vengono autenticate con la sessione attiva anziché con una chiave; nella dashboard compaiono con origine playground.