TikTok-Caption- & Hashtag-API: Endpoints und Limits
Koda stellt drei POST-Endpoints bereit – /api/v1/caption, /api/v1/hashtags und /api/v1/script –, authentifiziert über einen API-Key, den du selbst erstellst und widerrufst. Eine Caption oder ein Hashtag-Set kostet 1 Credit, ein Skript 2, und jede Antwort liefert credits_used und credits_remaining, damit dein eigener Code anhalten kann, bevor das Guthaben es tut. Credits kaufst du in Paketen, von $0.05 pro Stück bis hinunter zu $0.03, und sie sind getrennt von den Koda Coins, die das Studio ausgibt.
Was die drei Endpoints pro Aufruf kosten
Jeder Aufruf kostet ganze Credits, atomar abgebucht, sobald die Generierung erfolgreich war – ein fehlgeschlagener Aufruf wird nicht berechnet, weil die Abbuchung davon abhängt, dass das Guthaben zum Zeitpunkt des Schreibens noch reicht.
| Endpoint | Credits |
|---|---|
| POST /api/v1/caption | 1 |
| POST /api/v1/hashtags | 1 |
| POST /api/v1/script | 2 |
Was kostet ein Credit tatsächlich?
Vier Paketgrößen, und der Stückpreis sinkt mit der Größe: $0.05 pro Credit bei 100, $0.03 bei 5000. Eine Caption kostet zum besten Tarif drei Cent.
Credits verfallen nicht mit einem Abrechnungszeitraum, und sie sind keine Koda Coins. Ein Coin steht für 0,001 $ echter Anbieterkosten im Studio; ein API-Credit ist eine pauschale Verkaufseinheit. Die beiden werden nie ineinander umgerechnet, deshalb werden sie im Dashboard getrennt gezählt.
| Paket | Preis pro Credit |
|---|---|
| 100 Credits | $0.05 |
| 500 Credits | $0.04 |
| 1000 Credits | $0.035 |
| 5000 Credits | $0.03 |
Was dir eine Antwort außer dem Text liefert
Jede erfolgreiche Antwort enthält credits_used und credits_remaining. Genau das lohnt es sich anzubinden: Ein Batch-Job kann das Restguthaben aus dem letzten Aufruf lesen, statt einen separaten Endpoint abzufragen, und sich sauber selbst stoppen.
Ist das Guthaben zu niedrig, liefert der Aufruf HTTP 402 mit dem Code insufficient_credits und dem aktuellen Guthaben – der Fehler ist also programmatisch auswertbar, statt dass du einen Fehlertext parsen musst.
Was diese Funktion nicht macht
- Es generiert keine Videos, Bilder oder Stimmen. Die v1-API ist reiner Text – Captions, Hashtags und Skripte. Die Videogenerierung bleibt im Studio, wo sie in Coins pro Modell und pro Sekunde berechnet wird.
- Es veröffentlicht nicht. Nichts in v1 postet auf TikTok, Instagram oder YouTube; ein Konto verbinden und veröffentlichen sind Aktionen im Dashboard.
- Das Rate Limit liegt bei 5 Anfragen pro Minute und Endpoint – eine Obergrenze für Spitzen, kein Monatskontingent. Ein Job, der mehr braucht, muss sein Tempo selbst drosseln.
- Es gibt keinen Gratis-Tarif für die API. Credits werden vor dem ersten Aufruf gekauft.
Häufige Fragen
- Teilen sich API-Credits und Koda Coins ein Guthaben?
- Nein. Es sind zwei getrennte Guthaben, im Dashboard getrennt angezeigt. Koda Coins bezahlen Generierungen im Studio und bilden echte Anbieterkosten ab; API-Credits sind eine pauschale Verkaufseinheit, in Paketen für die v1-Endpoints gekauft.
- Was passiert mit einem fehlgeschlagenen Aufruf?
- Er wird nicht berechnet. Die Abbuchung ist ein bedingter Schreibvorgang, der nur greift, wenn das Guthaben noch reicht, und sie läuft erst, nachdem die Generierung zurückkommt – ein Anbieterfehler oder eine Ablehnung wegen des Rate Limits lässt das Guthaben also unberührt.
- Kann ein API-Key widerrufen werden?
- Ja, auf der Developer-Seite. Ein Key wird genau einmal vollständig angezeigt, bei der Erstellung, und kann jederzeit widerrufen werden; die Nutzung wird pro Key protokolliert, sodass du siehst, welcher was verbraucht hat.
Koda testen
So ist diese Seite entstanden: mit KI-Unterstützung verfasst, auf Grundlage der Einstellungen und Limits, mit denen Koda selbst läuft, geprüft am .
