API per didascalie e hashtag TikTok: endpoint e limiti
Koda espone tre endpoint POST (/api/v1/caption, /api/v1/hashtags e /api/v1/script) autenticati da una chiave API che crei e revochi tu. Una didascalia o un set di hashtag costa 1 credito, uno script 2, e ogni risposta restituisce credits_used e credits_remaining così il tuo codice può fermarsi prima che si esaurisca il saldo. I crediti si comprano a pacchetti, da $0.05 l’uno fino a $0.03, e sono separati dai Koda Coins che spende lo studio.
Quanto costa ogni chiamata ai tre endpoint
Ogni chiamata ha un prezzo in crediti interi, scalati in modo atomico solo quando la generazione riesce: una chiamata fallita non viene addebitata, perché l’addebito è condizionato al saldo ancora sufficiente al momento della scrittura.
| Endpoint | Crediti |
|---|---|
| POST /api/v1/caption | 1 |
| POST /api/v1/hashtags | 1 |
| POST /api/v1/script | 2 |
Quanto costa davvero un credito?
Quattro taglie di pacchetto, e il prezzo unitario scende con la taglia: $0.05 a credito con 100, $0.03 con 5000. Una didascalia alla tariffa migliore costa tre centesimi.
I crediti non scadono con il periodo di fatturazione e non sono Koda Coins. Un coin rappresenta $0.001 di costo reale dei fornitori dentro lo studio; un credito API è un’unità di vendita a prezzo fisso. I due non si convertono mai l’uno nell’altro, ed è per questo che nella dashboard sono conteggiati separatamente.
| Pacchetto | Prezzo per credito |
|---|---|
| 100 crediti | $0.05 |
| 500 crediti | $0.04 |
| 1000 crediti | $0.035 |
| 5000 crediti | $0.03 |
Cosa ti dà una risposta oltre al testo
Ogni risposta riuscita contiene credits_used e credits_remaining. È la parte che vale la pena collegare: un job a lotti può leggere il saldo residuo dall’ultima chiamata invece di interrogare un endpoint separato, e fermarsi in modo pulito.
Quando il saldo è troppo basso la chiamata restituisce HTTP 402 con il codice insufficient_credits e il saldo attuale, così l’errore si gestisce via codice invece di dover analizzare un messaggio di errore.
Cosa questa funzione non fa
- Non genera video, immagini né voce. L’API v1 è solo testo: didascalie, hashtag e script. La generazione video resta nello studio, dove ha un prezzo in coin per modello e per secondo.
- Non pubblica. Niente nella v1 pubblica su TikTok, Instagram o YouTube; collegare un account e pubblicare sono azioni della dashboard.
- Ha un limite di 5 richieste al minuto per endpoint, che è un tetto sui picchi, non una quota mensile. Un job che ha bisogno di più deve regolare il proprio ritmo.
- L’API non ha un livello gratuito. I crediti si comprano prima della prima chiamata.
Domande frequenti
- I crediti API e i Koda Coins condividono lo stesso saldo?
- No. Sono due saldi separati, mostrati separatamente nella dashboard. I Koda Coins pagano le generazioni dello studio e seguono il costo reale dei fornitori; i crediti API sono un’unità di vendita a prezzo fisso comprata a pacchetti per gli endpoint v1.
- Cosa succede a una chiamata che fallisce?
- Non viene addebitata. L’addebito è una scrittura condizionata che si applica solo quando il saldo è ancora sufficiente, e avviene dopo il ritorno della generazione: un errore del fornitore o un rifiuto per limite di frequenza lasciano il saldo intatto.
- Una chiave API si può revocare?
- Sì, dalla pagina Sviluppatori. Una chiave viene mostrata per intero una sola volta, alla creazione, e si può revocare in qualsiasi momento; l’utilizzo è registrato per chiave, così vedi quale ha speso cosa.
Prova Koda
Come è stata fatta questa pagina: scritta con l’aiuto dell’IA a partire dalle impostazioni e dai limiti su cui funziona Koda, verificati il .
