POST
/
api_keys
curl --request POST \
  --url https://geekai.co/api/v1/api_keys \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "geekai",
  "group": "balance",
  "credit_limit": 10000,
  "expired_at": "2025-12-31"
}'
{
  "data": {
    "uuid": "<string>",
    "name": "<string>",
    "value": "<string>",
    "raw_value": "<string>",
    "group": {
      "name": "<string>",
      "alias": "<string>",
      "desc": "<string>"
    },
    "credit_limit": 123,
    "credit_used": 123,
    "expired_at": "2023-12-25",
    "expired": true,
    "status": true,
    "last_used_at": "2023-11-07T05:31:56Z",
    "created_at": "2023-11-07T05:31:56Z"
  },
  "message": "<string>"
}

创建一个新的 API KEY。

注意：调用此接口需要依赖一个已存在的 API KEY，一般使用注册时自动创建的 API KEY 即可。

Authorizations

​
Authorization
string
header
required

JWT认证token

Body

application/json
​
name
string
default:default
required

名称，可用于标识 API KEY 的使用场景/用途，便于后续管理/统计费用

Example:

"geekai"

​
group
enum<string>
default:balance
required

代理策略分组，用于区分不同的代理策略，目前支持四个策略：lowcost（低价优先）, balance（均衡）, ha（高可用）, none（不使用代理）

Available options:
lowcost,
balance,
ha,
none
Example:

"balance"

​
credit_limit
number
default:0

信用额度，单位：金币（1金币=0.01元），用于限时 API KEY 的消费上限，超出额度后将无法继续使用，默认为 0，表示不限制信用额度

Example:

10000

​
expired_at
string
default:

过期时间，过期后将无法继续使用，默认为空，表示没有过期时间

Example:

"2025-12-31"

Response

200
application/json
成功响应
​
data
object

创建成功后返回的 API KEY 详细信息

​
message
string

成功/失败响应消息