API エンドポイント

クレジット照会

GET/v2/credits

クレジット API のクエリ

現在のユーザーのアカウント残高と信用情報を照会します。

GEThttps://udioapi.pro/api/v2/credits

tips

このエンドポイントを使用して、現在のアカウント残高と AI 音楽生成に使用可能なクレジットを確認します。

応答フィールド:

  • credits: 音楽生成に使用できる残りのクレジット
  • used_credits: 使用可能なクレジットの合計消費されている

キーの使用法:

  • 新しい生成タスクを開始する前に残りのクレジットを確認する
  • クレジット消費をリアルタイムで監視する
  • アプリケーションに残高不足警告を実装する

認証: Authorization ヘッダーにベアラー トークンを必ず含めますリクエストを認証します。

requestHeaders

namerequireddescription
Authorizationyes認証用のベアラー トークン。 「Bearer your_api_key」形式を使用します。

responses

json
{
  "code": 200,
  "message": "success",
  "data": {
    "credits": 195,
    "used_credits": 5
  }
}
json
{
  "code": 401,
  "message": "Unauthorized: Invalid or missing API key"
}
json
{
  "code": 403,
  "message": "Forbidden: Insufficient permissions to access credit information"
}
json
{
  "code": 429,
  "message": "Rate limit exceeded. Please try again later."
}
json
{
  "code": 500,
  "message": "Internal Server Error: Unable to retrieve credit information"
}

codeExamples

curl
curl -X GET "https://udioapi.pro/api/v2/credits" \
  -H "Authorization: Bearer YOUR_API_KEY"
javascript
const response = await fetch('https://udioapi.pro/api/v2/credits', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log('Remaining credits:', data.data.credits);
console.log('Used credits:', data.data.used_credits);