Chuyển đến nội dung
aitoken.tools
Đăng ký

Tài liệu API · Bắt đầu

Quyền và hạn mức của Key

Scope, danh sách mô hình được phép, hạn mức tổng và theo ngày, tắt và thu hồi Key.

Một tài khoản có thể tạo nhiều Key. Nên dùng riêng một Key cho mỗi ứng dụng hoặc môi trường để đặt hạn mức và thu hồi độc lập.

Quyền (scope)

scopeThao tác được phép
tasks:createGửi tác vụ tạo video; sẽ tạm giữ và quyết toán hạn mức
tasks:readTruy vấn trạng thái và kết quả tác vụ của tài khoản
assets:readLiệt kê và xem tài nguyên
assets:writeTải lên, nhập, đổi tên và xóa tài nguyên

Danh sách mô hình được phép

Key chỉ gọi được các mô hình đã chọn khi tạo Key, và đó phải là mô hình tài khoản đã được cấp quyền. Mô hình mới lên nền tảng không tự động được thêm vào danh sách của các Key cũ.

Hạn mức

  • Hạn mức tổng (bắt buộc): tổng số tiền đã quyết toán và đang tạm giữ của Key không được vượt quá giá trị này.
  • Hạn mức theo ngày (tùy chọn): tính theo ngày lịch ở múi giờ của trạm này (Asia/Shanghai).
  • Giới hạn RPM và số tác vụ đồng thời (tùy chọn): vượt quá sẽ trả về 429 rate_limited, xem Giới hạn tốc độ.
  • Thời hạn hiệu lực (tùy chọn): sau khi hết hạn, yêu cầu trả về 401 invalid_api_key.

Khi Key không đủ hạn mức, API trả về 402 key_limit_exceeded; khi tài khoản không đủ hạn mức khả dụng, API trả về 402 quota_exceeded.

Tắt và thu hồi

Key bị tắt có thể bật lại bất cứ lúc nào; Key bị thu hồi thì không thể khôi phục. Cả hai đều khiến mọi yêu cầu dùng Key đó lập tức trả về 401; lịch sử tác vụ và hóa đơn vẫn được giữ lại.

cURL
curl https://cn-api.aitoken.tools/v1/account/quota \
  -H "Authorization: Bearer $AITOKEN_API_KEY"

# {
#   "object": "quota",
#   "currency": "CNY",
#   "available": "496.800000",
#   "reserved": "3.200000",
#   "key": { "id": "key_xxx", "total_remaining": "96.800000", "daily_remaining": null }
# }