Skip to main content
GET
現在のユーザーアカウントの残高と使用済み残高を取得します。このエンドポイントは特定のトークンに依存しないユーザーレベルの残高情報を返し、アカウント全体の残高を確認するために使用されます。

認証

string
必須
すべてのAPIエンドポイントにはBearer Token認証が必要ですAPIキーの取得:APIキー管理ページにアクセスしてAPIキーを取得してくださいリクエストヘッダーに追加:

エンドポイント

両方のエンドポイントは同じ機能を持っています。どちらでも使用できます。

レスポンス

boolean
リクエストが成功したかどうか
string
エラーメッセージ(失敗時のみ返却)
float
ユーザー残高(成功時に返却)。
integer
ユーザー残りクレジット(成功時に返却)。
float
ユーザー使用済み残高(成功時に返却)
float
ユーザー使用済みクレジット(成功時に返却)

トークン残高 vs ユーザー残高

ユースケース

  • ユーザーアカウント全体の残高を確認
  • チャージリマインダーと残高アラートを設定
  • ユーザーダッシュボードでアカウント残高を表示
残高単位について残高の単位はシステム設定によって異なります:
  • USD - 米ドル
  • CNY - 人民元
  • Tokens - トークン数

一般的なエラー

セキュリティに関する注意APIキーはパスワードと同様です。安全に保管し、他人と共有しないでください。本番環境では必ずHTTPSを使用してください。