TikTok açıklama ve hashtag API’si: uç noktalar ve sınırlar

Koda’yı dene Son kontrol:

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ç noktaKredi
POST /api/v1/caption1
POST /api/v1/hashtags1
POST /api/v1/script2
Çağrı başına, anahtar başına. İstek sınırı her uç noktada 60 saniyede 5 istektir.

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.

PaketKredi başına fiyat
100 kredi$0.05
500 kredi$0.04
1000 kredi$0.035
5000 kredi$0.03
Paket boyutları ve bir kredinin birim fiyatı.

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

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: .