Passer au contenu principal

Création de clés API

Il existe deux types de jetons API :
  • Les jetons API personnels agissent en votre nom : les requêtes s’exécutent sous votre propre compte Krea, avec votre rôle dans l’espace de travail et l’accès à vos styles. Tout membre de l’espace de travail peut en créer un, et un jeton personnel cesse de fonctionner si vous quittez l’espace de travail.
  • Les jetons API de service agissent en tant qu’utilisateur de service distinct dans votre espace de travail, et non en tant que personne qui les a créés. Seuls les propriétaires et les administrateurs de l’espace de travail peuvent les créer. Les jetons de service continuent de fonctionner si leur créateur quitte l’espace de travail. Les propriétaires et les administrateurs de l’espace de travail peuvent voir tous les jetons de l’espace de travail, avec les dépenses sur 30 jours suivies pour chaque jeton de service.
Pour créer une clé API :
  1. Rendez-vous sur krea.ai/app/api/tokens
  2. Cliquez sur Create Personal Token ou Create Service Token
  3. Donnez un nom descriptif à votre clé
  4. Conservez le jeton en lieu sûr — vous ne le verrez qu’une seule fois !
Les jetons API personnels fonctionnent comme votre propre compte Krea : les styles que vous avez entraînés dans l’application leur sont donc directement accessibles. Les jetons API de service fonctionnent comme une identité d’utilisateur distincte au sein de votre espace de travail : les styles entraînés dans l’application ne seront pas accessibles via un jeton de service, et les styles entraînés via un jeton de service 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 :

Tarification

Pour les prix par modèle, consultez krea.ai/app/api/pricing ↗. 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 ↗.
L’Agent API et les outils Agent font exception : les tours de l’agent utilisent le solde d’unités de calcul de l’espace de travail, y compris lorsque l’authentification se fait avec une clé API. Ils n’utilisent pas le solde API.
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 :
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. Ce corps de réponse correspond au 402 lié au solde API. Le 402 de Zero Data Retention et les autres réponses 402 sont répertoriés dans Erreurs et débogage.

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

Consultez la page API Usage à l’adresse krea.ai/app/api/usage pour voir les tâches API terminées et les coûts estimés sur une plage de dates sélectionnable. Les gestionnaires de l’espace de travail voient l’utilisation de l’ensemble de l’espace de travail ; les autres membres voient l’utilisation de leurs propres jetons. La carte de solde API à l’adresse krea.ai/app/api/ affiche également le coût API estimé des 7 derniers jours.

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