TikTokキャプション・ハッシュタグAPI:エンドポイントと制限
Kodaは3つのPOSTエンドポイント(/api/v1/caption、/api/v1/hashtags、/api/v1/script)を公開しており、自分で作成・失効できるAPIキーで認証します。キャプションまたはハッシュタグのセットは1クレジット、台本は2クレジットで、すべてのレスポンスがcredits_usedとcredits_remainingを返すため、残高が尽きる前にあなたのコード側で止められます。クレジットはパックで購入し、1クレジット$0.05から$0.03まで。スタジオで使うKoda Coinsとは別物です。
3つのエンドポイントの1回あたりの費用
各呼び出しは整数のクレジットで価格が決まっており、生成が成功した時点でアトミックに差し引かれます。差し引きは書き込み時点で残高がまだ足りていることを条件にしているので、失敗した呼び出しは課金されません。
| エンドポイント | クレジット |
|---|---|
| POST /api/v1/caption | 1 |
| POST /api/v1/hashtags | 1 |
| POST /api/v1/script | 2 |
1クレジットは実際いくら?
パックのサイズは4種類で、サイズが大きいほど単価が下がります:100クレジットで1クレジット$0.05、5000クレジットで$0.03。最安のレートならキャプション1本は3セントです。
クレジットは請求期間とともに失効せず、Koda Coinsでもありません。1コインはスタジオ内での実際のプロバイダー費用0.001ドル分を表し、APIクレジットは定額の小売単位です。この2つが相互に換算されることはなく、だからダッシュボードでも別々に数えています。
| パック | 1クレジットあたりの価格 |
|---|---|
| 100クレジット | $0.05 |
| 500クレジット | $0.04 |
| 1000クレジット | $0.035 |
| 5000クレジット | $0.03 |
レスポンスがテキスト以外に返すもの
成功したレスポンスにはすべてcredits_usedとcredits_remainingが含まれます。ここは組み込む価値があります。バッチ処理は別のエンドポイントをポーリングする代わりに最後の呼び出しから残高を読み取り、きれいに自分で止まれます。
残高が足りないとき、呼び出しはHTTP 402とコードinsufficient_credits、そして現在の残高を返します。失敗はエラー文字列を解析するのではなく、プログラムで扱える形になっています。
この機能が やらないこと
- 動画、画像、音声は生成しません。v1 APIはテキスト専用で、キャプション、ハッシュタグ、台本だけです。動画生成はスタジオに残り、そこではモデルごと・秒ごとにコインで価格が決まります。
- 投稿はしません。v1にはTikTok、Instagram、YouTubeに投稿するものは何もありません。アカウントの連携と投稿はダッシュボードでの操作です。
- レート制限はエンドポイントごとに毎分5リクエストで、これは毎月の割り当てではなく、瞬間的な集中に対する上限です。それ以上が必要な処理は、自分でペースを調整する必要があります。
- APIに無料枠はありません。クレジットは最初の呼び出しの前に購入します。
よくある 質問
- APIクレジットとKoda Coinsは残高を共有する?
- いいえ。2つの別々の残高で、ダッシュボードでも別々に表示されます。Koda Coinsはスタジオでの生成に使い、実際のプロバイダー費用を反映します。APIクレジットは、v1エンドポイント用にパックで購入する定額の小売単位です。
- 失敗した呼び出しはどうなる?
- 課金されません。差し引きは残高がまだ足りている場合にだけ適用される条件付きの書き込みで、生成が返ってきた後に実行されます。そのため、プロバイダーのエラーやレート制限による拒否では残高は変わりません。
- APIキーは失効させられる?
- はい、Developerページから。キーが全文表示されるのは作成時の一度だけで、いつでも失効させられます。使用状況はキーごとに記録されるので、どのキーが何を使ったかを確認できます。
Kodaを試す
このページの作成方法: Koda自体が動いている設定と上限をもとにAIの支援で作成。確認日 .
