> ## 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
> Créez et gérez des clés API, rechargez votre solde API et comprenez la tarification par modèle afin de déployer des intégrations Krea avec des coûts prévisibles.
## Création de clés API
Seuls les **propriétaires** et les **administrateurs** de l'espace de travail peuvent créer des jetons API. Si l'option de création d'un jeton ne s'affiche pas, contactez le propriétaire de votre espace de travail pour demander l'accès ou un rôle plus élevé.
Pour créer une clé API :
1. Rendez-vous sur [krea.ai/settings/api-tokens](https://www.krea.ai/settings/api-tokens)
2. Assurez-vous d'être dans le bon espace de travail (à l'aide du sélecteur d'espace de travail en haut à gauche)
3. Cliquez sur « New Token »
4. Donnez un nom descriptif à votre jeton
5. Conservez le jeton en lieu sûr — vous ne le verrez qu'une seule fois !
L'API fonctionne comme sa propre identité d'utilisateur au sein de votre espace de travail. Les styles entraînés dans l'application ne seront pas accessibles via l'API, et les styles entraînés via l'API n'apparaîtront pas dans l'application, sauf s'ils sont partagés avec l'espace de travail. Consultez [Entraîner un style personnalisé](/developers/tutorials/train-image-style#use-your-trained-style) pour plus de détails.
**Recommandations de sécurité**
* Stockez les jetons dans des variables d'environnement, jamais dans le code
* Utilisez des jetons différents pour le développement et la production
* Révoquez immédiatement les jetons compromis
* Ne validez (commit) jamais de jetons dans un système de contrôle de version
* Ne partagez jamais de jetons publiquement
## Utilisation des clés API
Incluez votre jeton dans l'en-tête `Authorization` de toutes les requêtes :
```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"])
}
```
## Tarification
Pour les prix par modèle, consultez [krea.ai/features/api ↗](https://krea.ai/features/api). Chaque modèle a un prix fixe par génération déterminé par les paramètres de votre requête (résolution, qualité, audio, durée, références de style, etc.).
## Fonctionnement de la facturation API
Les appels API directs et les connexions MCP utilisant un jeton API sont prélevés sur un **solde en USD distinct** de votre espace de travail — indépendant des unités de calcul utilisées par l'application web Krea. Les connexions MCP utilisant OAuth sont facturées au compte Krea connecté en unités de calcul. L'accès API doit être activé sur votre espace de travail avant que vous puissiez utiliser des clés API ; si ce n'est pas le cas, contactez [support@krea.ai ↗](mailto:support@krea.ai).
Les jobs échoués et annulés ne sont pas facturés. Vous ne payez que pour les jobs terminés.
### Lorsque votre solde est épuisé
Les jobs en cours se terminent normalement. Les nouvelles requêtes API sont rejetées avec **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."
}
```
Rechargez sur [krea.ai/app/api/](https://krea.ai/app/api/) pour reprendre. Il n'existe pas d'endpoint public pour vérifier votre solde de manière programmatique — surveillez-le dans l'application.
## Ajouter du solde API
Ajoutez des fonds sur [krea.ai/app/api/](https://krea.ai/app/api/). Seuls les **propriétaires** de l'espace de travail peuvent ajouter du solde API.
* **Montants prédéfinis :** \$10, \$25, \$50, \$100
* **Montant personnalisé :** \$5 minimum, \$10 000 maximum
* Paiement via Stripe Checkout ; le solde est appliqué immédiatement en cas de succès
## Suivi de l'utilisation
Les dépenses récentes sont affichées sur la carte de solde API à l'adresse [krea.ai/app/api/](https://krea.ai/app/api/), sous « API cost in the last 7 days ».
## Entreprise
Les clients à fort volume peuvent être facturés mensuellement selon les conditions Net 30, plutôt qu'en prépaiement. Contactez [sales@krea.ai ↗](mailto:sales@krea.ai) pour discuter de la facturation entreprise.
## Étapes suivantes
Effectuez votre première requête API
Explorez tous les endpoints disponibles
Comprenez les états des jobs et le polling
Comprenez les limites de l'API selon le niveau d'abonnement