메인 콘텐츠로 건너뛰기
PUT
/
api
/
token
curl -X PUT https://api.cometapi.com/api/token/ \
  -H "Authorization: your-access-token" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 1234,
    "name": "production-renamed",
    "status": 1,
    "expired_time": -1,
    "remain_quota": 100000,
    "unlimited_quota": false,
    "model_limits_enabled": false,
    "model_limits": "",
    "allow_ips": null,
    "group": "",
    "cross_group_retry": false
  }'
{
  "success": true,
  "message": "",
  "data": {
    "id": 1234,
    "user_id": 5678,
    "key": "<COMETAPI_KEY>",
    "status": 1,
    "name": "production-renamed",
    "created_time": 1766102400,
    "accessed_time": 1766102400,
    "expired_time": -1,
    "remain_quota": 100000,
    "unlimited_quota": false,
    "model_limits_enabled": false,
    "model_limits": "",
    "allow_ips": null,
    "used_quota": 0,
    "group": "",
    "cross_group_retry": false
  }
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

이 엔드포인트를 사용하면 API 키의 이름, 상태, quota, 만료, 모델 제한, IP 허용 목록, 그룹 설정을 업데이트할 수 있습니다.
Console → Personal Settings에서 personal access token을 생성한 다음, 이를 원시 Authorization 헤더 값으로 전송하세요. Bearer 접두사는 붙이지 마세요.
이 엔드포인트는 PUT /api/token/을 사용하며, id는 JSON 본문에 들어가야 합니다. 유지하려는 수정 가능 필드를 함께 전송하세요. 생략된 숫자형, 불리언형 또는 문자열 필드는 업데이트 과정에서 재설정될 수 있습니다.

​
요청 본문

FieldTypeDescription
idinteger필수. List API keys에서 반환된 API 키 ID입니다.
namestring키의 사용자 친화적인 표시 이름입니다. 50자 이하여야 합니다.
statusinteger운영 상태입니다. 1은 모델 요청에 대해 키를 활성화합니다. 2는 비활성화합니다. 3은 만료됨으로 표시합니다. 4는 quota 소진으로 표시합니다. 비활성화되었거나, 만료되었거나, 소진된 키는 모델 엔드포인트에서 거부됩니다.
expired_timeinteger키가 만료되는 시점의 초 단위 Unix timestamp입니다. 만료 없음을 의미하려면 -1을 사용하세요. 과거 시점의 timestamp는 모델 요청을 차단합니다.
remain_quotaintegerCometAPI 내부 quota 단위 기준의 남은 quota입니다. 이 값이 0에 도달하고 unlimited_quota가 false이면, 이 키를 사용하는 모델 요청은 quota 소진으로 거부됩니다.
unlimited_quotaboolean키가 남은 quota 검사을 우회할지 여부입니다. remain_quota가 0이어도 키가 계속 동작해야 하는 경우에만 true로 설정하세요.
model_limits_enabledboolean이 키를 특정 모델로 제한할지 여부입니다. false이면 model_limits는 무시됩니다.
model_limitsstringmodel_limits_enabled가 true일 때 이 키에 허용되는 쉼표로 구분된 model ID 목록입니다. /v1/models에서 반환된 model ID를 사용하세요. 모델 제한이 없으면 빈 문자열을 사용하세요.
allow_ipsstring or null선택적 IP 허용 목록입니다. 항목 사이를 줄바꿈 문자(\n)로 구분한 하나의 JSON 문자열을 제공하세요. 각 항목은 단일 IPv4 주소, 단일 IPv6 주소, IPv4 CIDR 또는 IPv6 CIDR일 수 있습니다. IP 제한을 비활성화하려면 null 또는 ""를 사용하세요.
groupstring선택적 계정 그룹 제한입니다. 명시적 그룹이 없으면 빈 문자열을 사용하세요. 비어 있지 않은 값은 계정에서 사용 가능해야 하며, 그렇지 않으면 API는 success: false를 반환합니다.
cross_group_retryboolean자동 그룹 라우팅을 위한 cross-group retry 활성화 여부입니다. 이 값은 키가 자동 라우팅 그룹을 사용할 때만 의미가 있습니다.

​
허용 목록 형식

여러 IP 또는 CIDR 범위를 허용하려면, 항목 사이에 \n을 넣은 하나의 JSON 문자열로 전송하세요: 
{
  "allow_ips": "198.51.100.10\n203.0.113.0/24\n2001:db8::/32"
}
이 예시는 IPv4 주소 1개, IPv4 CIDR 범위 1개, IPv6 CIDR 범위 1개를 허용합니다.

인증

​
Authorization
string
header
필수

Personal access token copied from CometAPI Console > Personal Settings. Send the raw token value; do not prefix it with Bearer.

본문

application/json
​
id
integer
필수

Numeric API key ID returned by the list endpoint. For updates, send this value in the JSON body, not in the URL.

예시:

1234

​
name
string

User-readable display name for the API key. The backend accepts up to 50 Unicode characters; longer names return success: false with token name is too long.

Maximum string length: 50
예시:

"production"

​
status
enum<integer>

Operational status for the key. 1 enables the key for model requests, 2 disables it, 3 marks it expired, and 4 marks it quota exhausted. Disabled, expired, or exhausted keys are rejected by model endpoints.

사용 가능한 옵션:
1,
2,
3,
4
예시:

1

​
expired_time
integer

Unix timestamp in seconds when the key expires. Use -1 for no expiration. A past timestamp blocks model requests with this key.

예시:

-1

​
remain_quota
integer

Remaining quota to assign to the key in CometAPI internal quota units. If this reaches 0 while unlimited_quota is false, model requests with this key are rejected as quota exhausted.

예시:

100000

​
unlimited_quota
boolean

Whether the key bypasses remaining-quota checks. Set true only when the key should keep working even if remain_quota is 0.

예시:

false

​
model_limits_enabled
boolean

Whether to restrict this key to specific models. When true, only model IDs listed in model_limits are allowed. When false, model_limits is ignored.

예시:

false

​
model_limits
string

Comma-separated model IDs allowed by this key when model_limits_enabled is true. Use model IDs returned by /v1/models, for example <model-id-1>,<model-id-2>. Use an empty string for no model restriction.

예시:

""

​
allow_ips
string | null

Optional IP allowlist. Provide one JSON string with entries separated by newline characters (\n). Each entry can be a single IPv4 address, single IPv6 address, IPv4 CIDR, or IPv6 CIDR. Example for three allowlist entries: 198.51.100.10\n203.0.113.0/24\n2001:db8::/32. CometAPI compares the model request client IP to this list. Use null or "" to disable IP restrictions.

예시:

"198.51.100.10\n203.0.113.0/24\n2001:db8::/32"

​
group
string

Optional account group restriction. Use an empty string for no explicit group restriction. Non-empty values must be available to the account, or the API returns success: false with a no access to group message.

예시:

""

​
cross_group_retry
boolean

Whether cross-group retry is enabled for automatic group routing. This is only meaningful when the key uses an auto-routed group such as auto.

예시:

false

응답

200 - application/json

Updated API key record.

​
success
boolean
필수
​
message
string
필수
​
data
object
필수