API 키 업데이트 - CometAPI Documentation

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": "AbCd12****XyZ9",
    "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
  }
}

이 엔드포인트를 사용하여 API 키의 이름, 상태, 할당량, 만료, 모델 제한, IP 허용 목록 및 그룹 설정을 업데이트합니다.

개인 액세스 토큰은 api_key:write 권한으로 다음에서 생성할 수 있습니다: Console → Personal Settings. 토큰을 가공하지 않은 Authorization 헤더 값으로 전송하세요. Bearer 접두사를 붙이지 마세요.

응답에는 모델 요청을 인증할 수 없는 마스킹된 key 값을 포함한 업데이트된 레코드가 포함됩니다. data.key에서 전체 API 키를 저장하세요. API 키를 생성할 때. 저장하지 않았다면 다음을 여세요: Console → API Keys. 생성한 API 키를 찾아 Copy를 선택한 다음, 신원 확인을 완료하세요.

이 엔드포인트는 PUT /api/token/를 사용하며, id는 JSON 본문에 포함됩니다. 유지하려는 수정 가능 필드를 전송하세요. 생략된 숫자, 불리언 또는 문자열 필드는 업데이트 과정에서 재설정될 수 있습니다.

요청 본문

필드	유형	설명
`id`	정수	다음에서 반환된 필수 API 키 ID API 키 생성 또는 API 키 목록 조회.
`name`	문자열	키의 사용자 식별용 표시 이름입니다. 50자 이하여야 합니다.
`status`	정수	작동 상태입니다. `1`는 모델 요청에 키를 사용할 수 있게 합니다. `2`는 비활성화합니다. `3`는 만료됨으로 표시합니다. `4`는 할당량 소진으로 표시합니다. 비활성화되었거나 만료되었거나 할당량이 소진된 키는 모델 엔드포인트에서 거부됩니다.
`expired_time`	정수	키가 만료되는 시점의 Unix 타임스탬프(초)입니다. 만료를 설정하지 않으려면 `-1`를 사용하세요. 과거 타임스탬프는 모델 요청을 차단합니다.
`remain_quota`	정수	CometAPI 내부 할당량 단위의 남은 할당량입니다. 이 값이 `0`에 도달하고 `unlimited_quota`가 `false`이면, 이 키를 사용한 모델 요청은 할당량 소진으로 거부됩니다.
`unlimited_quota`	불리언	이 키가 `true`를 통해 남은 할당량 검사를 우회하는지 여부입니다. `remain_quota`가 `0`.
`model_limits_enabled`	불리언	이 키를 특정 모델로 제한할지 여부입니다. `false`이면 `model_limits`는 무시됩니다.
`model_limits`	문자열	`model_limits_enabled`가 `true`일 때 이 키에 허용되는 쉼표로 구분된 모델 ID입니다. `/v1/models`에서 반환된 모델 ID를 사용하세요. 모델 제한을 적용하지 않으려면 빈 문자열을 사용하세요.
`allow_ips`	문자열 또는 null	선택적 IP 허용 목록입니다. 줄바꿈 문자(`\n`)로 항목을 구분한 JSON 문자열 하나를 제공하세요. 각 항목은 단일 IPv4 주소, 단일 IPv6 주소, IPv4 CIDR 또는 IPv6 CIDR일 수 있습니다. IP 제한을 비활성화하려면 `null` 또는 `""`를 사용하세요.
`group`	문자열	선택적 계정 그룹 제한입니다. 명시적 그룹을 지정하지 않으려면 빈 문자열을 사용하세요. 비어 있지 않은 값은 계정에서 사용할 수 있어야 하며, 그렇지 않으면 API가 다음을 반환합니다: `success: false`.
`cross_group_retry`	불리언	자동 그룹 라우팅에 대한 그룹 간 재시도 활성화 여부입니다. 이는 키가 자동 라우팅 그룹을 사용할 때만 의미가 있습니다.

허용 목록 형식

여러 IP 또는 CIDR 범위를 허용하려면 항목 사이에 \n를 넣어 하나의 JSON 문자열로 전송하세요:

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

이 예에서는 IPv4 주소 하나, IPv4 CIDR 범위 하나 및 IPv6 CIDR 범위 하나를 허용합니다.

인증

Authorization

string

header

필수

Personal access token with the api_key:write permission, generated in CometAPI Console > Personal Settings. Send the raw token value; do not prefix it with Bearer.

본문

application/json

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

필수

Whether the operation succeeded.

message

string

필수

Status message. Empty on success.

data

object

필수

API key record with a masked key value.

Show child attributes

마지막 수정일 2026년 10월 26일

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": "AbCd12****XyZ9",
    "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
  }
}

​요청 본문

​허용 목록 형식

인증

본문

응답

요청 본문

허용 목록 형식