API Kapsyen & Hashtag TikTok: Endpoint dan Had
Koda menyediakan tiga endpoint POST — /api/v1/caption, /api/v1/hashtags dan /api/v1/script — yang disahkan dengan kunci API yang anda cipta dan batalkan sendiri. Satu kapsyen atau satu set hashtag berharga 1 kredit, satu skrip berharga 2, dan setiap respons memulangkan credits_used dan credits_remaining supaya kod anda sendiri boleh berhenti sebelum baki habis. Kredit dibeli dalam pek, dari $0.05 sekredit turun hingga $0.03, dan berasingan daripada Koda Coins yang dibelanjakan studio.
Kos setiap panggilan bagi tiga endpoint
Setiap panggilan diberi harga dalam kredit penuh, ditolak secara atomik sebaik penjanaan berjaya — panggilan yang gagal tidak dicaj, kerana potongan itu bersyarat pada baki yang masih mencukupi pada masa penulisan.
| Endpoint | Kredit |
|---|---|
| POST /api/v1/caption | 1 |
| POST /api/v1/hashtags | 1 |
| POST /api/v1/script | 2 |
Berapakah sebenarnya harga satu kredit?
Empat saiz pek, dan harga seunit turun mengikut saiz: $0.05 sekredit pada 100, $0.03 pada 5000. Satu kapsyen pada kadar terbaik berharga tiga sen.
Kredit tidak luput bersama tempoh bil dan ia bukan Koda Coins. Satu coin mewakili $0.001 kos pembekal sebenar dalam studio; satu kredit API ialah unit runcit tetap. Kedua-duanya tidak pernah ditukar antara satu sama lain, sebab itu ia dikira secara berasingan dalam papan pemuka.
| Pek | Harga sekredit |
|---|---|
| 100 kredit | $0.05 |
| 500 kredit | $0.04 |
| 1000 kredit | $0.035 |
| 5000 kredit | $0.03 |
Apa yang diberikan respons selain teks
Setiap respons yang berjaya membawa credits_used dan credits_remaining. Itulah bahagian yang patut disambungkan: kerja kelompok boleh membaca baki yang tinggal daripada panggilan terakhir dan bukannya meninjau endpoint berasingan, lalu berhenti dengan kemas.
Apabila baki terlalu rendah, panggilan memulangkan HTTP 402 dengan kod insufficient_credits dan baki semasa, jadi kegagalan itu boleh dikendalikan secara pengaturcaraan dan bukan dengan menghurai rentetan ralat.
Apa yang ciri ini tidak lakukan
- Ia tidak menjana video, imej atau suara. API v1 hanya teks — kapsyen, hashtag dan skrip. Penjanaan video kekal dalam studio, dengan harga dalam coin mengikut model dan mengikut saat.
- Ia tidak menerbitkan. Tiada apa-apa dalam v1 yang menyiar ke TikTok, Instagram atau YouTube; menyambung akaun dan menerbitkan ialah tindakan dalam papan pemuka.
- Ia dihadkan kepada 5 permintaan seminit bagi setiap endpoint, iaitu had lonjakan, bukan kuota bulanan. Kerja yang memerlukan lebih banyak perlu mengatur rentaknya sendiri.
- Tiada peringkat percuma pada API. Kredit dibeli sebelum panggilan pertama.
Soalan lazim
- Adakah kredit API dan Koda Coins berkongsi baki?
- Tidak. Ia dua baki berasingan yang dipaparkan secara berasingan dalam papan pemuka. Koda Coins membayar penjanaan studio dan mengikut kos pembekal sebenar; kredit API ialah unit runcit tetap yang dibeli dalam pek untuk endpoint v1.
- Apa yang berlaku pada panggilan yang gagal?
- Ia tidak dicaj. Potongan itu ialah penulisan bersyarat yang hanya terpakai apabila baki masih mencukupi, dan ia berjalan selepas penjanaan selesai — jadi ralat pembekal atau penolakan had kadar membiarkan baki tidak terusik.
- Bolehkah kunci API dibatalkan?
- Boleh, dari halaman Developer. Kunci dipaparkan sepenuhnya tepat sekali, semasa dicipta, dan boleh dibatalkan pada bila-bila masa; penggunaan direkodkan bagi setiap kunci supaya anda boleh melihat kunci mana yang membelanjakan apa.
Cuba Koda
Cara halaman ini dihasilkan: ditulis dengan bantuan AI daripada tetapan dan had yang digunakan Koda sendiri, disemak pada .
