API 接口

查询积分

GET/v2/credits

积分查询API

查询当前用户的账户余额和信用信息。

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

tips

使用此端点检查您当前的帐户余额和用于 AI 音乐生成的可用积分。

响应字段:

  • credits:可用于音乐生成的剩余积分
  • used_credits:已使用的总积分已消耗

密钥用法:

  • 在开始新一代任务之前检查剩余积分
  • 实时监控积分消耗
  • 在应用程序中实施低余额警告

身份验证:始终在授权标头中包含您的承载令牌,以验证您的身份请求。

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);