Passer au contenu principal

​
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
  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é 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 : 
// 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}`);

​
Tarification

Pour les prix par modèle, consultez 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 ↗.
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 : 
{
  "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/ 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/. 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/, 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 ↗ pour discuter de la facturation entreprise.

​
Étapes suivantes

Playground interactif

Effectuez votre première requête API

API de modèles

Explorez tous les endpoints disponibles

Cycle de vie d'un job

Comprenez les états des jobs et le polling

Limites de débit

Comprenez les limites de l’API selon le niveau d’abonnement