Mô-đun Bảng điều khiển thanh toán tài khoản

Nên sử dụng HTTPS trong môi trường sản xuất để bảo mật mã thông báo xác thực. HTTP chỉ được khuyến nghị cho môi trường phát triển.

Giao diện truy vấn thanh toán tương thích OpenAI SDK. Sử dụng xác thực Token để cung cấp thông tin đăng ký và truy vấn sử dụng. Chủ yếu dành cho các ứng dụng của bên thứ ba và tích hợp SDK, đảm bảo khả năng tương thích hoàn toàn với API OpenAI.

🔐 Xác thực người dùng

Truy xuất thông tin hạn ngạch đăng ký

• Tên giao diện: Truy xuất thông tin hạn ngạch đăng ký
• Phương thức HTTP: NHẬN
• Đường dẫn: /dashboard/billing/subscription
• Yêu cầu xác thực: Mã thông báo người dùng
• Mô tả chức năng: Truy xuất thông tin hạn ngạch đăng ký của người dùng, bao gồm tổng hạn ngạch, giới hạn cứng và thời hạn hiệu lực truy cập, tương thích với định dạng API OpenAI

💡 Yêu cầu Ví dụ:

const response = await fetch('/dashboard/billing/subscription', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Ví dụ phản hồi thành công:

{
  "object": "billing_subscription",
  "has_payment_method": true,
  "soft_limit_usd": 100.0,
  "hard_limit_usd": 100.0,
  "system_hard_limit_usd": 100.0,
  "access_until": 1640995200
}

❗ Ví dụ phản hồi không thành công:

{
  "error": {
    "message": "Failed to obtain quota",
    "type": "upstream_error"
  }
}

🧾 Mô tả trường:

• object (Chuỗi): Giá trị cố định “billing_subscription”
• has_payment_method (Boolean): Phương thức thanh toán có tồn tại hay không, cố định là true
• soft_limit_usd (Số): Hạn ngạch giới hạn mềm (USD)
• hard_limit_usd (Số): Hạn mức giới hạn cứng (USD)
• system_hard_limit_usd (Number): Hạn ngạch giới hạn cứng hệ thống (USD)
• access_until (Number): Dấu thời gian hiệu lực truy cập, Thời gian hết hạn Token

Đường dẫn tương thích OpenAI SDK - Truy xuất thông tin hạn ngạch đăng ký

• Tên giao diện: Đường dẫn tương thích OpenAI SDK - Truy xuất thông tin hạn ngạch đăng ký
• Phương thức HTTP: NHẬN
• Đường dẫn: /v1/dashboard/billing/subscription
• Yêu cầu xác thực: Mã thông báo người dùng
• Mô tả chức năng: Về mặt chức năng giống với giao diện ở trên, cung cấp đường dẫn tương thích với OpenAI SDK

💡 Yêu cầu Ví dụ:

const response = await fetch('/v1/dashboard/billing/subscription', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Ví dụ phản hồi thành công:

{
  "object": "billing_subscription",
  "has_payment_method": true,
  "soft_limit_usd": 100.0,
  "hard_limit_usd": 100.0,
  "system_hard_limit_usd": 100.0,
  "access_until": 1640995200
}

❗ Ví dụ phản hồi không thành công:

{
  "error": {
    "message": "Failed to obtain quota",
    "type": "upstream_error"
  }
}

🧾 Mô tả trường:

• object (Chuỗi): Giá trị cố định “billing_subscription”
• has_payment_method (Boolean): Phương thức thanh toán có tồn tại hay không, cố định là true
• soft_limit_usd (Số): Hạn ngạch giới hạn mềm (USD)
• hard_limit_usd (Số): Hạn mức giới hạn cứng (USD)
• system_hard_limit_usd (Number): Hạn ngạch giới hạn cứng hệ thống (USD)
• access_until (Number): Dấu thời gian hiệu lực truy cập, Thời gian hết hạn Token

Truy xuất thông tin sử dụng

• Tên giao diện: Truy xuất thông tin sử dụng
• Phương thức HTTP: NHẬN
• Đường dẫn: /dashboard/billing/usage
• Yêu cầu xác thực: Mã thông báo người dùng
• Mô tả chức năng: Truy xuất thông tin sử dụng hạn ngạch của người dùng, tương thích với định dạng API OpenAI

💡 Yêu cầu Ví dụ:

const response = await fetch('/dashboard/billing/usage', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Ví dụ phản hồi thành công:

{
  "object": "list",
  "total_usage": 2500.0
}

❗ Ví dụ phản hồi không thành công:

{
  "error": {
    "message": "Failed to get usage",
    "type": "new_api_error"
  }
}

🧾 Mô tả trường:

• object (String): “danh sách” giá trị cố định
• total_usage (Số): Tổng mức sử dụng, tính bằng đơn vị $0,01 USD

Đường dẫn tương thích OpenAI SDK - Truy xuất thông tin sử dụng

• Tên giao diện: Đường dẫn tương thích OpenAI SDK - Truy xuất thông tin sử dụng
• Phương thức HTTP: NHẬN
• Đường dẫn: /v1/dashboard/billing/usage
• Yêu cầu xác thực: Mã thông báo người dùng
• Mô tả chức năng: Về mặt chức năng giống với giao diện ở trên, cung cấp đường dẫn tương thích với OpenAI SDK

💡 Yêu cầu Ví dụ:

const response = await fetch('/v1/dashboard/billing/usage', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Ví dụ phản hồi thành công:

{
  "object": "list",
  "total_usage": 2500.0
}

❗ Ví dụ phản hồi không thành công:

{
  "error": {
    "message": "Failed to get usage",
    "type": "new_api_error"
  }
}

🧾 Mô tả trường:

• object (String): “danh sách” giá trị cố định
• total_usage (Số): Tổng mức sử dụng, tính bằng đơn vị $0,01 USD