Premiers pas avec l’API KIE
Bienvenue sur KIE. Ce guide vous guide à travers les informations essentielles pour intégrer les API KIE à votre produit, notamment les modèles, les tarifs, l'authentification, le flux de requêtes, les limites et le support. Nous visons à être transparents, pratiques et conviviaux pour les développeurs. Veuillez lire attentivement ce guide avant de passer en production.
1. Modèles disponibles & Playground
Vous trouverez les derniers modèles pris en charge sur notre page Marché : 👉 https://kie.ai/market Nous mettons régulièrement à jour notre catalogue avec les nouveaux modèles dès qu’ils sont stables. Chaque page de modèle est liée à un Playground, où vous pouvez tester et expérimenter directement dans notre interface avant de faire une requête à l’API. Le Playground est l’endroit idéal pour comprendre le comportement des modèles, leurs paramètres et les formats de sortie.
2. Tarifs
La liste complète et à jour des tarifs est disponible ici : 👉 https://kie.ai/pricing Nos prix sont généralement 30 % à 50 % inférieurs à ceux des APIs officiels. Pour certains modèles, des réductions jusqu'à 80 % sont possibles. Les tarifs peuvent évoluer si les fournisseurs upstream ajustent leurs coûts, nous vous recommandons donc de toujours consulter la page des tarifs pour obtenir les derniers chiffres.
3. Création et sécurisation de votre clé API
Créez et gérez vos clés API ici : 👉 https://kie.ai/api-key Notes importantes sur la sécurité : Ne jamais divulguer votre clé API dans le code frontend (navigateur, applications mobiles, dépôts publics). Traitez votre clé API comme un secret. Pour protéger votre utilisation, nous proposons : - Des limites de fréquence (horaire, quotidienne et cumulée) - Un système de liste blanche IP, permettant uniquement aux IPs serveur approuvées d’accéder à l’API Ces fonctionnalités aident à éviter les surutilisations accidentelles et les requêtes non autorisées.
4. En-têtes de requête requis
Chaque requête API doit inclure les en-têtes corrects :
Authorization : Bearer
5. Journaux & Détails des Tâches
Vous pouvez consulter toutes vos tâches historiques ici : 👉 https://kie.ai/logs Pour chaque tâche, vous pouvez voir : - Date de création - Modèle utilisé - Paramètres d’entrée - Statut de la tâche - Consommation de crédits - Résultats finaux ou détails de l’erreur Si vous suspectez une utilisation incorrecte des crédits, cette page est la source de vérité pour vérification.
6. Politique de Conservation des Données
Veuillez noter nos règles de conservation : - Fichiers média générés : stockés pendant 14 jours, puis supprimés automatiquement - Enregistrements de logs (texte / métadonnées) : stockés pendant 2 mois, puis supprimés automatiquement Si vous souhaitez un accès à long terme, assurez-vous de télécharger et de stocker les résultats de votre côté à temps.
7. Modèle de tâche asynchrone
Toutes les tâches de génération sur KIE sont asynchrones. Une requête réussie renvoie : HTTP 200 un task_id Un code 200 signifie uniquement que la tâche a été créée, pas qu’elle est terminée. Pour obtenir le résultat final, vous devez soit fournir une URL de callback (webhook) dans la requête, soit interroger activement l’API « query record info » en utilisant le task_id
Limites de fréquence et concurrence
Par défaut, les limites suivantes s'appliquent : Jusqu'à 20 requêtes de génération nouvelles toutes les 10 secondes Cela permet généralement d'exécuter plus de 100 tâches en parallèle Les limites s'appliquent par compte Si vous dépassez cette limite : Les requêtes seront rejetées avec le code 429 Les requêtes rejetées ne seront pas mises en file d'attente Pour la plupart des utilisateurs, ces limites sont plus que suffisantes. Si vous obtenez régulièrement des erreurs 429, vous pouvez contacter le support pour demander une augmentation de limite — les demandes sont traitées avec prudence.
Support pour développeurs
Les canaux de support recommandés sont accessibles directement depuis le tableau de bord (menu en bas à gauche) : Demander de l’aide sur Discord Demander de l’aide sur Telegram Ce que vous recevez : Des canaux privés et à 1 contre 1 Vos données et vos conversations restent confidentielles Des réponses plus rapides et plus techniques Heures de disponibilité : de 21h à 17h (jour suivant) UTC Vous pouvez aussi nous envoyer un email à [email protected], mais ce n’est pas la méthode la plus rapide ni préférée.
Attentes en matière de stabilité
Nous proposons un accès aux API de pointe, hautement compétitives, à des prix très compétitifs. Cela dit : Nous ne sommes pas parfaits Notre stabilité globale peut être légèrement inférieure à celle des fournisseurs officiels C’est un compromis délibéré En pratique, KIE est suffisamment stable pour soutenir des charges de travail de production et une croissance à long terme, mais nous croyons en la mise en place d’attentes réalistes dès le départ.
À propos de l’équipe
KIE est développé par une petite équipe de startup. Nous progressons rapidement Nous nous soucions profondément de l’expérience utilisateur développeur Nous nous perfectionnons continuellement En même temps, nous reconnaissons que : Il n’y a pas de perfection absolue Nous ne pouvons pas satisfaire tous les cas d’usage immédiatement Votre retour nous aide à progresser — et nous l’apprécions sincèrement.