API リファレンス

レート制限

TokSpan のレート制限システム、クォータ、およびアプリケーションで制限エラーを適切に処理する方法について説明します。

レート制限ヘッダー

すべての API レスポンスには以下のレート制限ヘッダーが含まれます:

ヘッダー説明
x-ratelimit-limit-requests1分間あたりの最大リクエスト数
x-ratelimit-remaining-requests現在のウィンドウでの残りリクエスト数
x-ratelimit-limit-tokens1分間あたりの最大トークン数
x-ratelimit-remaining-tokens現在のウィンドウでの残りトークン数
x-ratelimit-reset-requestsリクエストクォータがリセットされるまでの秒数

デフォルト制限値

ティアRPMTPM
無料60100,000
従量課金5001,000,000
エンタープライズカスタムカスタム

制限を超過すると、API は 429 Too Many Requests を返します。本番環境の耐障害性のために、ジッター付きの指数バックオフを実装してください。