> ## Documentation Index
> Fetch the complete documentation index at: https://www.krea.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# API Keys & Billing
> Crea e gestisci chiavi API, ricarica il tuo saldo API e comprendi i prezzi per modello così puoi rilasciare integrazioni Krea con costi prevedibili.
## 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](https://www.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](/developers/tutorials/train-image-style#use-your-trained-style) 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:
```javascript Node.js theme={null}
// 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}`);
```
```bash cURL theme={null}
curl -X POST https://api.krea.ai/generate/image/bfl/flux-1-dev \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"prompt": "a serene mountain landscape at sunset",
"width": 1024,
"height": 576
}'
```
```python Python theme={null}
import requests
API_BASE = "https://api.krea.ai"
API_TOKEN = "your-api-token"
response = requests.post(
f"{API_BASE}/generate/image/bfl/flux-1-dev",
headers={
"Authorization": f"Bearer {API_TOKEN}",
"Content-Type": "application/json"
},
json={
"prompt": "a serene mountain landscape at sunset",
"width": 1024,
"height": 576
}
)
job = response.json()
print(f"Job ID: {job['job_id']}")
```
```go Go theme={null}
package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
func main() {
apiBase := "https://api.krea.ai"
apiToken := "your-api-token"
payload := map[string]interface{}{
"prompt": "a serene mountain landscape at sunset",
"width": 1024,
"height": 576,
}
jsonData, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", apiBase+"/generate/image/bfl/flux-1-dev", bytes.NewBuffer(jsonData))
req.Header.Set("Authorization", "Bearer "+apiToken)
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
var job map[string]interface{}
json.NewDecoder(resp.Body).Decode(&job)
fmt.Printf("Job ID: %s\n", job["job_id"])
}
```
## Prezzi
Per i prezzi per modello, vedi [krea.ai/features/api ↗](https://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 ↗](mailto: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**:
```json theme={null}
{
"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/](https://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/](https://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/](https://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 ↗](mailto:sales@krea.ai) per discutere la fatturazione enterprise.
## Prossimi passi
Effettua la tua prima richiesta API
Esplora tutti gli endpoint disponibili
Comprendi gli stati dei job e il polling
Comprendi i limiti API per livello di piano