メインコンテンツへスキップ

エンドポイント

GET /v1/credits

概要

現在のテナントのクレジット残高を照会します。キータイプに関係なく使用可能な共通エンドポイントです。

リクエスト

curl https://api.ones1ght.com/v1/credits \
  -H "Authorization: Bearer $API_KEY"

レスポンス

{
  "success": true,
  "data": {
    "balance": 150.00
  }
}
フィールド説明
balance利用可能なクレジット残高(USD)

チャットレスポンスのクレジット情報

POST /v1/chat/{persona_id}のレスポンスにもクレジット情報が含まれます:
{
  "success": true,
  "data": {
    "thread_id": "thr_xxx",
    "assistant_message": { ... },
    "credits": {
      "used": 289,
      "balance": 149.50
    }
  }
}
フィールド説明
credits.usedこのリクエストで使用されたトークン数
credits.balanceリクエスト後の残りクレジット残高(USD)
クレジットが枯渇すると、チャットAPI呼び出し時に402 Payment Requiredが返されます。