API สอบถามยอดคงเหลือในบัญชี

อัปเดต 2026-09-18 · ทีม Suno-API

คำอธิบายเอนด์พอยต์

การสอบถามยอดคงเหลือในบัญชีช่วยให้ผู้ใช้ตรวจสอบยอดคงเหลือของบัญชี New API ด้วยคีย์ API ของตนเอง เอนด์พอยต์นี้เพียงสอบถามยอดคงเหลือ ไม่ก่อให้เกิดงานสร้างเพลงและไม่คิดค่าใช้จ่าย

เอนด์พอยต์: GET /api/user/balance

ค่าบริการ: ฟรี

หน่วยของยอดคงเหลือ: yuan ในคำตอบ ค่า effective_amount ถูกแปลงด้วย quota_per_unit เป็นจำนวนเงินหยวนที่ผู้ใช้เข้าใจได้แล้ว

พารามิเตอร์คำขอ

Headers

พารามิเตอร์ query

ไม่มี

ตัวอย่างคำขอ

cURL

curl -X GET https://www.suno-api.io/api/user/balance \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import requests

api_key = "YOUR_API_KEY"
response = requests.get(
    "https://www.suno-api.io/api/user/balance",
    headers={"Authorization": f"Bearer {api_key}"},
    timeout=30,
)
response.raise_for_status()

result = response.json()
balance = result["data"]["balance"]
print(balance["formatted_effective_amount"])

Node.js

const apiKey = "YOUR_API_KEY";

const response = await fetch("https://www.suno-api.io/api/user/balance", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${apiKey}`,
  },
});

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const result = await response.json();
console.log(result.data.balance.formatted_effective_amount);

PHP

<?php
$apiKey = "YOUR_API_KEY";

$ch = curl_init("https://www.suno-api.io/api/user/balance");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer " . $apiKey
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
if ($response === false) {
    throw new Exception(curl_error($ch));
}
curl_close($ch);

$result = json_decode($response, true);
echo $result["data"]["balance"]["formatted_effective_amount"];
?>

คำตอบ

{
  "success": true,
  "message": "",
  "data": {
    "object": "user_balance",
    "user": {
      "id": 123,
      "username": "example",
      "quota": 207900000,
      "used_quota": 0,
      "request_count": 10,
      "group": "default",
      "status": 1
    },
    "token": {
      "id": 456,
      "name": "default",
      "group": "default",
      "status": 1,
      "remain_quota": 207900000,
      "used_quota": 0,
      "unlimited_quota": true,
      "model_limits_enabled": false,
      "model_limits": {}
    },
    "balance": {
      "user_quota": 207900000,
      "token_quota": 207900000,
      "effective_quota": 207900000,
      "user_amount": 415.8,
      "token_amount": 415.8,
      "effective_amount": 415.8,
      "amount_unit": "yuan",
      "formatted_effective_amount": "415.80 yuan"
    },
    "display": {
      "quota_per_unit": 500000,
      "amount_unit": "yuan"
    }
  }
}

คำอธิบายฟิลด์

หมายเหตุ

• เอนด์พอยต์นี้ใช้คีย์ API เดียวกับเอนด์พอยต์สำหรับสร้างเพลง
• แม้ยอดคงเหลือของคีย์ API หมดแล้ว ก็ยังสอบถามยอดคงเหลือได้
• คีย์ API ที่ถูกปิดใช้งานหรือหมดอายุจะสอบถามไม่ได้
• เอนด์พอยต์ไม่คืนค่า USD, CNY, $ หรือ ¥ แต่ใช้ yuan เสมอ เพื่อลดความเข้าใจผิด