TikTok açıklama ve hashtag API’si: uç noktalar ve sınırlar
Koda üç POST uç noktası sunar — /api/v1/caption, /api/v1/hashtags ve /api/v1/script — kimlik doğrulaması kendin oluşturup iptal ettiğin bir API anahtarıyla yapılır. Bir açıklama ya da hashtag seti 1 kredi, bir senaryo 2 kredi tutar ve her yanıt credits_used ve credits_remaining döndürür; böylece kendi kodun bakiye bitmeden durabilir. Krediler paketler halinde satın alınır, tanesi $0.05’dan $0.03’a kadar iner ve stüdyonun harcadığı Koda Coins’ten ayrıdır.
Üç uç noktanın çağrı başına maliyeti
Her çağrı tam kredi olarak fiyatlandırılır ve üretim başarılı olduğunda atomik olarak düşülür — başarısız bir çağrı faturalandırılmaz, çünkü kesinti yazma anında bakiyenin hâlâ yeterli olmasına bağlıdır.
| Uç nokta | Kredi |
|---|---|
| POST /api/v1/caption | 1 |
| POST /api/v1/hashtags | 1 |
| POST /api/v1/script | 2 |
Bir kredi gerçekte ne kadar tutar?
Dört paket boyutu var ve birim fiyat boyutla birlikte düşer: 100’lük pakette kredi başına $0.05, 5000’likte $0.03. En iyi fiyattan bir açıklama üç sent tutar.
Kredilerin süresi bir fatura dönemiyle dolmaz ve Koda Coins değildirler. Bir coin stüdyo içinde $0.001’lık gerçek sağlayıcı maliyetini temsil eder; bir API kredisi ise sabit bir perakende birimidir. İkisi asla birbirine dönüşmez; panelde ayrı sayılmalarının nedeni bu.
| Paket | Kredi başına fiyat |
|---|---|
| 100 kredi | $0.05 |
| 500 kredi | $0.04 |
| 1000 kredi | $0.035 |
| 5000 kredi | $0.03 |
Bir yanıt metnin yanında sana ne verir
Her başarılı yanıt credits_used ve credits_remaining taşır. Bağlanmaya değer kısım bu: bir toplu iş, ayrı bir uç noktayı yoklamak yerine kalan bakiyeyi son çağrıdan okuyabilir ve kendini temiz bir şekilde durdurabilir.
Bakiye çok düşük olduğunda çağrı, insufficient_credits koduyla ve mevcut bakiyeyle HTTP 402 döndürür; böylece hata bir hata metninin ayrıştırılması yerine programatik olarak ele alınabilir.
Bu özelliğin yapmadıkları
- Video, görsel ya da ses üretmez. v1 API’si yalnızca metindir — açıklamalar, hashtag’ler ve senaryolar. Video üretimi, model ve saniye başına coin ile fiyatlandırıldığı stüdyoda kalır.
- Yayın yapmaz. v1’deki hiçbir şey TikTok, Instagram ya da YouTube’a paylaşım yapmaz; hesap bağlamak ve yayımlamak panel işlemleridir.
- Uç nokta başına dakikada 5 istekle sınırlıdır; bu aylık bir kota değil, ani yüklenmeler için bir tavandır. Daha fazlasına ihtiyaç duyan bir iş kendi temposunu ayarlamalıdır.
- API’de ücretsiz bir kademe yok. Krediler ilk çağrıdan önce satın alınır.
Sık sorulan sorular
- API kredileri ve Koda Coins aynı bakiyeyi mi paylaşır?
- Hayır. Panelde ayrı gösterilen iki ayrı bakiyedir. Koda Coins stüdyo üretimlerinin bedelini öder ve gerçek sağlayıcı maliyetini izler; API kredileri ise v1 uç noktaları için paketler halinde satın alınan sabit bir perakende birimidir.
- Başarısız olan bir çağrıya ne olur?
- Faturalandırılmaz. Kesinti, yalnızca bakiye hâlâ yeterliyse uygulanan koşullu bir yazmadır ve üretim döndükten sonra çalışır — yani bir sağlayıcı hatası ya da istek sınırı reddi bakiyeye dokunmaz.
- Bir API anahtarı iptal edilebilir mi?
- Evet, Geliştirici sayfasından. Bir anahtar oluşturulduğu anda yalnızca bir kez tam olarak gösterilir ve her an iptal edilebilir; kullanım anahtar başına kaydedilir, böylece hangisinin neyi harcadığını görebilirsin.
Koda’yı dene
Bu sayfa nasıl hazırlandı: Koda’nın kendi çalıştığı ayar ve sınırlardan yapay zekâ yardımıyla yazıldı; kontrol tarihi: .
