API Caption & Hashtag TikTok: Endpoint dan Batas
Koda menyediakan tiga endpoint POST — /api/v1/caption, /api/v1/hashtags, dan /api/v1/script — yang diautentikasi dengan API key yang Anda buat dan cabut sendiri. Satu caption atau satu set hashtag berharga 1 kredit, satu naskah 2, dan setiap respons mengembalikan credits_used dan credits_remaining agar kode Anda sendiri bisa berhenti sebelum saldonya habis. Kredit dibeli dalam paket, dari $0.05 per kredit turun hingga $0.03, dan terpisah dari Koda Coins yang dipakai studio.
Berapa biaya ketiga endpoint per panggilan
Setiap panggilan diberi harga dalam kredit utuh, dipotong secara atomik setelah pembuatan berhasil — panggilan yang gagal tidak ditagih, karena pemotongannya bersyarat pada saldo yang masih cukup saat penulisan.
| Endpoint | Kredit |
|---|---|
| POST /api/v1/caption | 1 |
| POST /api/v1/hashtags | 1 |
| POST /api/v1/script | 2 |
Berapa sebenarnya harga satu kredit?
Empat ukuran paket, dan harga satuannya turun seiring ukurannya: $0.05 per kredit di 100, $0.03 di 5000. Satu caption dengan tarif terbaik seharga tiga sen.
Kredit tidak kedaluwarsa bersama periode tagihan dan bukan Koda Coins. Satu coin mewakili $0.001 biaya penyedia sungguhan di dalam studio; satu kredit API adalah unit eceran tetap. Keduanya tidak pernah saling dikonversi, itulah sebabnya dihitung terpisah di dasbor.
| Paket | Harga per kredit |
|---|---|
| 100 kredit | $0.05 |
| 500 kredit | $0.04 |
| 1000 kredit | $0.035 |
| 5000 kredit | $0.03 |
Apa yang diberikan respons selain teksnya
Setiap respons yang berhasil membawa credits_used dan credits_remaining. Itulah bagian yang layak disambungkan: job batch bisa membaca sisa saldo dari panggilan terakhir alih-alih melakukan polling ke endpoint terpisah, lalu berhenti dengan rapi.
Saat saldo terlalu rendah, panggilan mengembalikan HTTP 402 dengan kode insufficient_credits dan saldo saat ini, jadi kegagalannya bisa ditangani lewat program, bukan dengan mengurai string error.
Yang tidak dilakukan fitur ini
- Fitur ini tidak membuat video, gambar, atau suara. API v1 hanya teks — caption, hashtag, dan naskah. Pembuatan video tetap di studio, dengan harga dalam coin per model dan per detik.
- Fitur ini tidak memublikasikan. Tidak ada apa pun di v1 yang memposting ke TikTok, Instagram, atau YouTube; menghubungkan akun dan memublikasikan adalah tindakan di dasbor.
- Batas rate-nya 5 request per menit per endpoint, yaitu batas lonjakan, bukan kuota bulanan. Job yang butuh lebih banyak harus mengatur temponya sendiri.
- Tidak ada tingkat gratis di API. Kredit dibeli sebelum panggilan pertama.
Pertanyaan umum
- Apakah kredit API dan Koda Coins berbagi saldo?
- Tidak. Keduanya dua saldo terpisah yang ditampilkan terpisah di dasbor. Koda Coins membayar pembuatan di studio dan mengikuti biaya penyedia sungguhan; kredit API adalah unit eceran tetap yang dibeli dalam paket untuk endpoint v1.
- Apa yang terjadi pada panggilan yang gagal?
- Tidak ditagih. Pemotongannya adalah penulisan bersyarat yang hanya berlaku jika saldo masih cukup, dan dijalankan setelah pembuatan selesai — jadi error dari penyedia atau penolakan batas rate membuat saldo tidak tersentuh.
- Bisakah API key dicabut?
- Bisa, dari halaman Developer. Key ditampilkan lengkap tepat satu kali, saat dibuat, dan bisa dicabut kapan saja; penggunaan dicatat per key sehingga Anda bisa melihat key mana yang menghabiskan apa.
Coba Koda
Cara halaman ini dibuat: ditulis dengan bantuan AI dari pengaturan dan batas yang dipakai Koda sendiri, dicek pada .
