查询单个API Key配置

接口路径

GET /api/open/token/:id

配额计算说明

配额字段为内部额度单位，换算成金额（人民币）的方式：

金额(¥) = quota ÷ quota_per_unit × usd_exchange_rate

其中：

• quota：来自本接口返回的 data.remain_quota（剩余）或 data.used_quota（已用）；月度相关可用 data.monthly_quota_limit、data.current_month_used
• quota_per_unit、usd_exchange_rate、quota_display_type：来自 查询换算参数 接口（GET /api/open/status）

若 quota_display_type = USD（美元），则去掉 × usd_exchange_rate。

当 unlimited_quota = true 时，令牌额度不受限，不必用 remain_quota 换算「剩余余额」。

请求参数

字段	类型	是否必传	说明	限制条件	备注
id	int	是	Token 记录 ID	须为正整数	示例: 5001

请求示例

GET 'https://neolink.com/backend/api/open/token/5001'
GET 'https://neolink.com/backend/api/open/token/5002'

返回信息

字段	类型	是否必传	说明	备注
success	bool	是	请求是否成功	固定值
message	string	是	错误提示信息（成功时为空）	固定值
data	Token	是	单个 Token 对象	详见下表

Token 对象字段说明

字段	类型	是否必传	说明	备注
id	int	是	Token 记录 ID	数据库唯一标识
name	string	是	Token 名称	自定义名称
key	string	是	密钥显示值	仅显示后4位
status	int	是	Token 状态	1=正常；2=禁用；3=已过期；4=预算不足
created_time	int64	是	创建时间	Unix 秒级时间戳
accessed_time	int64	否	最后访问时间	Unix 秒级时间戳；未访问过则为 0
expired_time	int64	是	过期时间	Unix 秒级时间戳；-1=永不过期
remain_quota	int64	是	剩余配额	当前可用配额；换算见上文「配额计算说明」
used_quota	int64	是	已用配额	已消耗配额；换算见上文「配额计算说明」
unlimited_quota	bool	是	是否无限配额	true=不受限；false=受限
user_id	int	是	所属用户 ID	创建者用户 ID
enterprise_id	int	是	企业 ID	所属企业
organization_id	int	是	组织 ID	所属部门
busi_type	int	是	业务类型	1=API；2=其他
group	string	是	主分组	默认分组名
groups	[]string	是	分组数组	所属的全部分组
model_limits	string	是	模型限制	逗号分隔模型列表
model_limits_enabled	bool	是	模型限制是否启用	true=启用；false=不启用
allow_ips	string	是	IP 白名单	逗号分隔 IP 或 CIDR
monthly_quota_limit	int64	是	月配额上限	当月最高配额限制
current_month	int	是	当前月份	格式 YYYYMM
current_month_used	int64	是	当月已用	当月消耗配额
cross_group_retry	bool	是	跨分组重试	true=启用；false=禁用
created_by_member_id	int	是	创建人成员 ID	企业内创建者的成员ID
member_display_name	string	是	创建人显示名	真名或昵称
member_username	string	是	创建人用户名	登录用户名
member_mobile_masked	string	是	创建人手机号（掩码）	仅显示后4位
creator_deleted	bool	是	创建人是否已删除	true=已删除；false=正常

返回示例

成功响应
{
  "success": true,
  "message": "",
  "data": {
    "id": 5001,
    "name": "api-key-prod-1",
    "key": "sk-****a5b0",
    "status": 1,
    "created_time": 1711468800,
    "accessed_time": 1711584000,
    "expired_time": -1,
    "remain_quota": 1000000,
    "used_quota": 500000,
    "unlimited_quota": false,
    "user_id": 100,
    "enterprise_id": 1001,
    "organization_id": 2001,
    "busi_type": 1,
    "group": "default",
    "groups": ["default", "premium"],
    "groups_meta": [
      {
        "name": "default",
        "ratio": "1",
        "desc": "默认分组"
      },
      {
        "name": "premium",
        "ratio": "1.5",
        "desc": "高级分组"
      }
    ],
    "model_limits": "gpt-4,gpt-3.5-turbo",
    "model_limits_enabled": true,
    "allow_ips": "10.0.0.1,192.168.1.0/24",
    "monthly_quota_limit": 2000000,
    "current_month": 202607,
    "current_month_used": 300000,
    "cross_group_retry": true,
    "created_by_member_id": 101,
    "member_display_name": "",
    "member_username": "",
    "member_mobile_masked": "",
    "creator_display_name": "",
    "creator_deleted": false
  }
}
错误响应
{
  "success": false,
  "message": "令牌不存在或已删除"
}