Vai al contenuto principale

Creare chiavi API

Esistono due tipi di token API:
  • I token API personali agiscono come te: le richieste vengono eseguite con il tuo account Krea, con il tuo ruolo nel workspace e l’accesso ai tuoi stili. Qualsiasi membro del workspace può crearne uno, e un token personale smette di funzionare se lasci il workspace.
  • I token API di servizio agiscono come un utente di servizio separato nel tuo workspace, non come la persona che li ha creati. Solo i proprietari e gli amministratori del workspace possono crearli. I token di servizio continuano a funzionare anche se il loro creatore lascia il workspace. I proprietari e gli amministratori del workspace possono vedere tutti i token del workspace, con la spesa degli ultimi 30 giorni tracciata per ogni token di servizio.
Per creare una chiave API:
  1. Vai su krea.ai/app/api/tokens
  2. Clicca su Create Personal Token o Create Service Token
  3. Dai alla tua chiave un nome descrittivo
  4. Salva il token in modo sicuro—lo vedrai solo una volta!
I token API personali operano come il tuo account Krea, quindi gli stili che hai addestrato nell’app sono direttamente disponibili. I token API di servizio operano come un’identità utente separata all’interno del tuo workspace: gli stili addestrati nell’app non saranno accessibili tramite un token di servizio, e gli stili addestrati tramite un token di servizio non appariranno nell’app, a meno che non siano condivisi con il workspace. Vedi Addestra uno stile personalizzato per i dettagli.
Linee guida di sicurezza
  • Conserva i token in variabili d’ambiente, mai nel codice
  • Usa token diversi per sviluppo e produzione
  • Revoca immediatamente i token se compromessi
  • Non fare mai commit dei token nel controllo versione
  • Non condividere mai i token pubblicamente

Usare le chiavi API

Includi il tuo token nell’header Authorization di tutte le richieste:

Prezzi

Per i prezzi per modello, vedi krea.ai/app/api/pricing ↗. Ogni modello ha un prezzo fisso per generazione determinato dai parametri della tua richiesta (risoluzione, qualità, audio, durata, riferimenti di stile, ecc.).

Come funziona la fatturazione dell’API

Le chiamate API dirette e le connessioni MCP che usano un token API attingono da un saldo USD separato sul tuo workspace — indipendente dalle unità di calcolo usate dall’app web di Krea. Le connessioni MCP che usano OAuth vengono addebitate all’account Krea con cui hai effettuato l’accesso utilizzando le unità di calcolo. L’accesso API deve essere abilitato sul tuo workspace prima che tu possa usare le chiavi API; se non lo è, contatta support@krea.ai ↗.
La Agent API e gli strumenti Agent sono un’eccezione: i turni dell’agente usano il saldo di unità di calcolo del workspace, anche quando l’autenticazione avviene con una chiave API. Non usano il saldo API.
I job falliti e annullati non vengono fatturati. Paghi solo per i job completati.

Quando il saldo si esaurisce

I job in corso terminano normalmente. Le nuove richieste API vengono rifiutate con HTTP 402 Payment Required:
Ricarica su krea.ai/app/api/ per riprendere. Non esiste un endpoint pubblico per verificare il tuo saldo in modo programmatico — monitoralo nell’app. Questo body è il 402 del saldo API. Il 402 di Zero Data Retention e le altre risposte 402 sono elencati in Errori e debugging.

Aggiungere saldo API

Aggiungi fondi su krea.ai/app/api/. Solo i proprietari del workspace possono aggiungere saldo API.
  • Importi preimpostati: $10, $25, $50, $100
  • Importo personalizzato: $5 minimo, $10.000 massimo
  • Pagato tramite Stripe Checkout; il saldo si applica immediatamente in caso di successo

Monitorare l’utilizzo

Consulta la pagina API Usage su krea.ai/app/api/usage per i job API completati e i costi stimati in un intervallo di date selezionabile. I manager del workspace vedono l’utilizzo dell’intero workspace; gli altri membri vedono l’utilizzo dei propri token. Anche la scheda del saldo API su krea.ai/app/api/ mostra il costo API stimato degli ultimi 7 giorni.

Enterprise

I clienti con volumi più elevati possono essere fatturati mensilmente con termini Net 30 invece di pagare in anticipo. Contatta sales@krea.ai ↗ per discutere la fatturazione enterprise.

Prossimi passi

Playground interattivo

Effettua la tua prima richiesta API

API dei modelli

Esplora tutti gli endpoint disponibili

Ciclo di vita del job

Comprendi gli stati dei job e il polling

Limiti di velocità

Comprendi i limiti API per livello di piano