API 密钥
获取单个 API key
按 ID 检索当前已认证账户的一条 CometAPI API key 记录。
GET
cURL
使用此端点可按 ID 检索一条 API key 记录。
路径参数
在 控制台 → 个人设置 生成个人访问令牌,然后将其作为原始
Authorization 请求头值发送。不要添加 Bearer 前缀。id 是由 列出 API key 返回的数字 key ID。
API key 状态
| 状态 | 含义 |
|---|---|
1 | 已启用 |
2 | 已禁用 |
3 | 已过期 |
4 | 已耗尽 |
返回字段
| 字段 | 类型 | 描述 |
|---|---|---|
id | integer | 数字 API key ID。可将此值用于 更新 API key 和 删除 API key。 |
key | string | 管理 API 返回的 API key 值。请将其视为机密,并在模型请求中按 Authorization: Bearer $COMETAPI_KEY 使用。 |
status | integer | 运行状态。只有 1 表示该 key 已为模型请求启用。 |
name | string | 供用户识别的 key 显示名称。 |
created_time | integer | 该 key 创建时间的 Unix 时间戳(秒)。 |
accessed_time | integer | 该 key 上次使用时间的 Unix 时间戳(秒)。 |
expired_time | integer | 该 key 过期时间的 Unix 时间戳(秒)。-1 表示永不过期。 |
remain_quota | integer | 以 CometAPI 内部配额单位表示的剩余配额。 |
used_quota | integer | 此 key 已消耗的配额,以 CometAPI 内部配额单位表示。 |
unlimited_quota | boolean | 该 key 是否跳过剩余配额检查。 |
model_limits_enabled | boolean | 该 key 是否启用模型限制。 |
model_limits | string | 当 model_limits_enabled 为 true 时,此 key 允许使用的、以逗号分隔的 model ID。空值表示未配置模型列表。 |
allow_ips | string or null | IP 允许名单,格式为一个以换行符分隔的字符串。每一项可以是单个 IPv4 地址、单个 IPv6 地址、IPv4 CIDR 或 IPv6 CIDR。null 或 "" 表示没有 IP 限制。 |
group | string | 账户分组限制。空值表示没有显式分组限制。 |
cross_group_retry | boolean | 是否启用跨分组重试以进行自动分组路由。 |
授权
Personal access token copied from CometAPI Console > Personal Settings. Send the raw token value; do not prefix it with Bearer.
路径参数
Numeric API key ID returned by the list endpoint.