API 参考
更新 API 密钥
更新现有 Standard API 密钥，并获取其当前用量汇总。
更新现有 Standard API 密钥，并获取其当前用量汇总。
端点
- 基础 URL
https://runapi.ai- API 版本
v1- 身份验证
Authorization: Bearer YOUR_MANAGEMENT_API_KEY- 授权
- 需要账户管理员的 Management API 密钥，并且只允许更新其用户拥有的密钥。
03
JSON 请求体请求
只能在列出的请求位置发送值。
JSON 请求体5 个字段
allowed_modelsarray | null
可选
Replacement model allowlist; null or an empty array clears it.
credit_limit_centsinteger | null
可选
Spending cap in USD cents; null clears the cap and reset interval.
credit_limit_reset_intervalstring | null
可选
Reset cadence for the spending cap.
可选值:daily, weekly, monthly
enabledboolean
可选
Whether requests using this key are accepted.
namestring
可选
Replacement friendly name for the API key.
路径参数1 个字段
idstring
必填
API key prefix ID, for example token_123.
03
HTTP 200成功响应
PATCH /api/v1/keys/:id
JSON
{
"allowed_models": [
"gpt-5.4"
],
"created_at": "2026-07-27T10:00:00.000Z",
"credit_limit_cents": 1000,
"credit_limit_reset_interval": "daily",
"credit_usage_cents_by_model": {
"gpt-5.4": 250
},
"credit_usage_cents_this_month": 250,
"credit_usage_cents_this_week": 100,
"credit_usage_cents_today": 25,
"credit_usage_cents_total": 250,
"enabled": true,
"guardrail_id": "guardrail_123",
"id": "token_123",
"last_used_at": null,
"masked_token": "runapi_abc...wxyz",
"name": "Production primary"
}04
HTTP 401错误响应 (401)
JSON
{
"error": "Authentication required"
}05
HTTP 403错误响应 (403)
JSON
{
"error": "Management API key required"
}06
HTTP 403错误响应 (403)
JSON
{
"error": "Account admin required"
}07
HTTP 400错误响应 (400)
JSON
{
"error": "page must be an integer"
}08
HTTP 404错误响应 (404)
JSON
{
"error": "Resource not found"
}09
HTTP 422错误响应 (422)
JSON
{
"errors": {
"base": [
"Validation failed"
]
}
}10
cURL 示例
CURL
curl -X PATCH https://runapi.ai/api/v1/keys/token_123 \
-H 'Authorization: Bearer YOUR_MANAGEMENT_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"name":"Production primary","enabled":true}'11