Khóa API
Liệt kê API keys
Liệt kê API keys CometAPI cho tài khoản đã xác thực với phân trang.
GET
cURL
Dùng endpoint này để liệt kê các API keys thuộc về tài khoản CometAPI đã xác thực. Các key mới nhất được trả về trước.
Tạo một personal access token tại Console → Personal Settings, rồi gửi nó dưới dạng giá trị thô của header
Authorization. Không thêm tiền tố Bearer.Phân trang
| Query parameter | Description |
|---|---|
p | Số trang. Mặc định là 1. |
page_size | Số mục trên mỗi trang. Giá trị trên 100 sẽ bị giới hạn ở 100. |
Trạng thái API key
| Status | Meaning |
|---|---|
1 | Đã bật |
2 | Đã tắt |
3 | Đã hết hạn |
4 | Đã hết quota |
Các trường trả về
| Field | Type | Description |
|---|---|---|
id | integer | ID số của API key. Dùng giá trị này với Get a single API key, Update an API key, và Delete an API key. |
key | string | Giá trị API key do management API trả về. Hãy coi nó như bí mật và dùng nó dưới dạng Authorization: Bearer $COMETAPI_KEY cho các yêu cầu model. |
status | integer | Trạng thái hoạt động. Chỉ 1 nghĩa là key đã được bật cho các yêu cầu model. |
name | string | Tên hiển thị, dễ đọc cho người dùng, của key. |
created_time | integer | Unix timestamp tính bằng giây khi key được tạo. |
accessed_time | integer | Unix timestamp tính bằng giây khi key được dùng lần cuối. |
expired_time | integer | Unix timestamp tính bằng giây khi key hết hạn. -1 nghĩa là không hết hạn. |
remain_quota | integer | Quota còn lại tính theo đơn vị quota nội bộ của CometAPI. |
used_quota | integer | Quota đã được key này tiêu thụ tính theo đơn vị quota nội bộ của CometAPI. |
unlimited_quota | boolean | Cho biết key có bỏ qua kiểm tra quota còn lại hay không. |
model_limits_enabled | boolean | Cho biết có áp dụng giới hạn model cho key này hay không. |
model_limits | string | Các model ID được phép bởi key này, phân tách bằng dấu phẩy, khi model_limits_enabled là true. Để trống nghĩa là chưa cấu hình danh sách model. |
allow_ips | string or null | IP allowlist dưới dạng một chuỗi ngăn cách bằng dấu xuống dòng. Mỗi mục có thể là một địa chỉ IPv4 đơn, một địa chỉ IPv6 đơn, IPv4 CIDR, hoặc IPv6 CIDR. null hoặc "" nghĩa là không có giới hạn IP. |
group | string | Giới hạn theo nhóm tài khoản. Để trống nghĩa là không có giới hạn nhóm rõ ràng. |
cross_group_retry | boolean | Cho biết cross-group retry có được bật cho tự động định tuyến theo nhóm hay không. |
Ủy quyền
Personal access token copied from CometAPI Console > Personal Settings. Send the raw token value; do not prefix it with Bearer.
Tham số truy vấn
Page number to return. Defaults to 1.
Phạm vi bắt buộc:
x >= 1Number of keys per page. Values above 100 are capped at 100 by the backend.
Phạm vi bắt buộc:
1 <= x <= 100