生成令牌（API Key）

请求参数

Query 参数

p

string

可选

页码（0为第一页、1为第二页、2为第三页...）

示例值:

0

pageSize

string

每页展示数量

可选

示例值:

10

Header 参数

Authorization

string

可选

填入你的系统令牌（例如你的系统令牌为abc123则设置：abc123）

示例值:

Body 参数application/json

备注

name

string

key名称

必需

自定义

expired_time

integer

过期时间

必需

用Unix 时间戳表示过期时间（如：1751808821），-1为永不过期

billing_type

integer

计费类型

必需

1-按量计费，2-按次计费，3-混合计费，-4按量优先，-5按次优先。一般建议4

models

string

模型限制

必需

可用模型限制，留空不限制

ip_whitelist

string

IP白名单

必需

填入IP地址（段），支持IPv4/IPv6，多个地址用英文逗号分隔，留空不限制

rate_limit_duration

integer

周期

必需

单位：秒，留空不限制

rate_limit_num

integer

周期内限流次数

必需

单位：次，需跟上一项搭配使用,留空不限制

rate_limit_exceeded_message

string

超速提示

必需

内容自定义，留空显示默认提示

ad_position

integer

广告位置

必需

普通账户不生效保持示例值-1即可

string

广告内容

必需

普通用户不生效，留空即可

remain_quota

integer

余额

必需

每500000quota=1美元，-1为无限额度

示例

{
  "name": "ocoolai的令牌",
  "expired_time": -1,
  "billing_type": 4,
  "models": "",
  "ip_whitelist": "",
  "rate_limit_duration": 0,
  "rate_limit_num": 0,
  "rate_limit_exceeded_message": "",
  "ad_position": -1,
  "advertisement": "",
  "remain_quota": 5000000
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://one.ooo.cool/api/token/?p=0&pageSize=10' \
--header 'Authorization: {{你的系统令牌}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "name": "ocoolai的令牌",
  "expired_time": -1,
  "billing_type": 4,
  "models": "",
  "ip_whitelist": "",
  "rate_limit_duration": 0,
  "rate_limit_num": 0,
  "rate_limit_exceeded_message": "",
  "ad_position": -1,
  "advertisement": "",
  "remain_quota": 5000000
}'

返回响应

🟢200成功

application/json

Body

id

integer

令牌id

可选

user_id

integer

用户id

可选

key

string

可选

key（需要手动在key前加上“sk-”）

status

integer

可选

令牌状态（1-启用，2-禁用）

name

string

令牌名称

可选

created_time

integer

创建日期

可选

accessed_time

integer

最后使用时间

可选

expired_time

integer

可选

过期时间（-1为永不过期）

remain_quota

integer

令牌额度

可选

unlimited_quota

boolean

是否为无限额度

可选

used_quota

integer

已用额度

可选

models

string

可用模型

可选

subnet

string

可选

ip_whitelist

string

ip白名单

可选

billing_type

integer

可选

计费模式（1-按量计费，2-按次计费，3-混合模式，4-按量优先，5按次优先）

is_initial_token

boolean

是否为初始令牌

可选

remark

string

令牌备注

可选

string

广告内容

可选

ad_position

integer

广告位置

可选

示例

{
  "data": {
    "id": 663,
    "user_id": 5381,
    "key": "ofNP5ZUwNKKMZWqU406aE03b321e4cEfA877793d4d4cC1Fb",
    "status": 1,
    "name": "测试令牌",
    "created_time": 1720062719,
    "accessed_time": 1720062719,
    "expired_time": -1,
    "remain_quota": 5000000,
    "unlimited_quota": false,
    "used_quota": 0,
    "models": "",
    "subnet": "",
    "ip_whitelist": "",
    "billing_type": 4,
    "is_initial_token": false,
    "remark": "",
    "advertisement": "",
    "ad_position": 0
  },
  "message": "",
  "success": true
}