使用法

＃ 使用法

API 統合の場合、現在安定したアカウントのチェックは プロフィール です。これを使用して、大規模な操作の前にクレジット、層、および残りの API クォータを読み取ります。専用使用エンドポイントはスキーマ駆動型として扱う必要があります。GET /api/openapi.json に存在するパスのみを呼び出します。

＃＃ リクエスト

プロファイルは通常のベアラー認証されたリクエストを使用します。

GET /api/open/v1/profile
Authorization: Bearer KITTA_API_KEY

curl https://kittaai.com/api/open/v1/profile \
  -H "Authorization: Bearer KITTA_API_KEY"

＃＃ 応答

{
  "user_id": "user_123",
  "api_quota_remaining": 988000,
  "tier": "pro",
  "credits": 1200
}

応答は予約としてではなく、運用上のガードレールとして使用してください。あなたがチェックした後、他のワーカーが残高を消費する可能性があります。

請求とクレジット

高価なバッチの残高スナップショットを保存します。顧客がバッチが停止した理由を尋ねた場合は、開始プロファイル スナップショット、完了したジョブ数、失敗したジョブ数、および最終プロファイル スナップショットを比較します。

エラー

プロファイル エラーは、共有 API エラー形状に従います。将来の使用エンドポイントがスキーマに表示される場合は、同じ再試行とログのルールを適用します。つまり、requestId をログに記録し、API キーのログを回避し、クレジットが不十分な場合はバッチ作成を一時停止します。