API légendes et hashtags TikTok : endpoints et limites

Essayer Koda Vérifié le

Koda expose trois endpoints POST — /api/v1/caption, /api/v1/hashtags et /api/v1/script —, authentifiés par une clé API que tu crées et révoques toi-même. Une légende ou un jeu de hashtags coûte 1 crédit, un script 2, et chaque réponse renvoie credits_used et credits_remaining pour que ton code puisse s’arrêter avant le solde. Les crédits s’achètent par packs, de 0,05 $ l’unité jusqu’à 0,03 $, et sont distincts des Koda Coins que dépense le studio.

Ce que coûtent les trois endpoints par appel

Chaque appel est facturé en crédits entiers, débités de façon atomique une fois la génération réussie — un appel qui échoue n’est pas facturé, parce que le débit n’a lieu que si le solde est encore suffisant au moment de l’écriture.

EndpointCrédits
POST /api/v1/caption1
POST /api/v1/hashtags1
POST /api/v1/script2
Par appel, par clé. Limite de 5 requêtes par 60 secondes sur chaque endpoint.

Combien coûte vraiment un crédit ?

Quatre tailles de pack, et le prix unitaire baisse avec la taille : 0,05 $ le crédit à 100, 0,03 $ à 5000. Au meilleur tarif, une légende coûte trois centimes.

Les crédits n’expirent pas avec une période de facturation, et ce ne sont pas des Koda Coins. Un coin représente 0,001 $ de coût fournisseur réel dans le studio ; un crédit API est une unité de vente à prix fixe. Les deux ne se convertissent jamais l’un en l’autre, c’est pour ça qu’ils sont comptés séparément dans le tableau de bord.

PackPrix par crédit
100 crédits$0.05
500 crédits$0.04
1000 crédits$0.035
5000 crédits$0.03
Tailles de pack et prix de revient d’un crédit.

Ce que donne une réponse en plus du texte

Chaque réponse réussie contient credits_used et credits_remaining. C’est la partie qui vaut la peine d’être branchée : un traitement par lots peut lire le solde restant sur le dernier appel au lieu d’interroger un endpoint à part, et s’arrêter proprement.

Quand le solde est trop bas, l’appel renvoie HTTP 402 avec le code insufficient_credits et le solde actuel : l’échec se traite dans le code, sans avoir à analyser un message d’erreur.

Ce que ça ne fait pas

  • Il ne génère ni vidéo, ni image, ni voix. L’API v1 ne fait que du texte — légendes, hashtags et scripts. La génération vidéo reste dans le studio, où elle est facturée en coins selon le modèle et la durée.
  • Il ne publie pas. Rien dans la v1 ne publie sur TikTok, Instagram ou YouTube ; connecter un compte et publier se font depuis le tableau de bord.
  • Il est limité à 5 requêtes par minute et par endpoint, ce qui plafonne les rafales, pas un quota mensuel. Un traitement qui a besoin de plus doit se régler sur ce rythme.
  • Il n’y a pas d’offre gratuite sur l’API. Les crédits s’achètent avant le premier appel.

Questions fréquentes

Les crédits API et les Koda Coins partagent-ils le même solde ?
Non. Ce sont deux soldes distincts, affichés séparément dans le tableau de bord. Les Koda Coins paient les générations du studio et suivent le coût fournisseur réel ; les crédits API sont une unité de vente à prix fixe achetée par packs pour les endpoints v1.
Que devient un appel qui échoue ?
Il n’est pas facturé. Le débit est une écriture conditionnelle qui ne s’applique que si le solde est encore suffisant, et il a lieu après le retour de la génération — une erreur du fournisseur ou un refus pour limite de requêtes laisse donc le solde intact.
Peut-on révoquer une clé API ?
Oui, depuis la page Développeur. Une clé n’est affichée en entier qu’une seule fois, à sa création, et peut être révoquée à tout moment ; l’utilisation est enregistrée clé par clé pour que tu voies laquelle a dépensé quoi.

Essayer Koda

Essayer Koda

Comment cette page a été faite : rédigée avec l’aide d’une IA à partir des réglages et limites sur lesquels Koda fonctionne, vérifiés le .