Vai al contenuto principale

​
Creare chiavi API

Solo i proprietari e gli amministratori del workspace possono creare token API. Se non vedi l’opzione per creare un token, contatta il proprietario del tuo workspace per richiedere l’accesso o un ruolo più elevato. Per creare una chiave API:
  1. Vai su krea.ai/settings/api-tokens
  2. Assicurati di essere nel workspace corretto (usando l’interruttore del workspace in alto a sinistra)
  3. Clicca su “New Token”
  4. Dai al tuo token un nome descrittivo
  5. Salva il token in modo sicuro—lo vedrai solo una volta!
L’API opera come un’identità utente a sé all’interno del tuo workspace. Gli stili addestrati nell’app non saranno accessibili tramite l’API, e gli stili addestrati tramite l’API 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: 
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

const job = await krea.image("bfl/flux-1-dev", {
  prompt: "a serene mountain landscape at sunset",
  width: 1024,
  height: 576
});

console.log(`Job ID: ${job.job_id}`);

​
Prezzi

Per i prezzi per modello, vedi krea.ai/features/api ↗. 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 ↗.
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: 
{
  "message": "Your API balance is separate from your workspace compute balance. Please top up your API balance to continue using the API."
}
Ricarica su krea.ai/app/api/ per riprendere. Non esiste un endpoint pubblico per verificare il tuo saldo in modo programmatico — monitoralo nell’app.

​
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

La spesa recente è mostrata sulla scheda del saldo API su krea.ai/app/api/ sotto “API cost in the last 7 days”.

​
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