API 키
단일 API 키 가져오기
인증된 계정에 대해 ID로 CometAPI API 키 레코드 하나를 조회합니다.
GET
cURL
이 엔드포인트를 사용하여 ID로 API 키 레코드 하나를 조회합니다.
Console → Personal Settings에서 personal access token을 생성한 다음, 이를 raw
Authorization 헤더 값으로 전송하세요. Bearer를 접두사로 붙이지 마세요.id 경로 매개변수는 API 키 목록 보기에서 반환된 숫자 키 ID입니다.
API 키 상태
| Status | Meaning |
|---|---|
1 | 활성화됨 |
2 | 비활성화됨 |
3 | 만료됨 |
4 | 소진됨 |
반환 필드
| Field | Type | Description |
|---|---|---|
id | integer | 숫자 API 키 ID입니다. 이 값을 API 키 업데이트 및 API 키 삭제에 사용하세요. |
key | string | 관리 API에서 반환되는 API 키 값입니다. 비밀로 취급하고 모델 요청에는 Authorization: Bearer $COMETAPI_KEY로 사용하세요. |
status | integer | 운영 상태입니다. 1만 해당 키가 모델 요청에 대해 활성화되었음을 의미합니다. |
name | string | 키에 대한 사람이 읽을 수 있는 표시 이름입니다. |
created_time | integer | 키가 생성된 시점의 Unix 타임스탬프(초)입니다. |
accessed_time | integer | 키가 마지막으로 사용된 시점의 Unix 타임스탬프(초)입니다. |
expired_time | integer | 키가 만료되는 시점의 Unix 타임스탬프(초)입니다. -1은 만료 없음을 의미합니다. |
remain_quota | integer | CometAPI 내부 quota 단위로 남은 quota입니다. |
used_quota | integer | CometAPI 내부 quota 단위로 이 키가 이미 사용한 quota입니다. |
unlimited_quota | boolean | 키가 남은 quota 검사에서 제외되는지 여부입니다. |
model_limits_enabled | boolean | 이 키에 대해 model 제한이 활성화되어 있는지 여부입니다. |
model_limits | string | model_limits_enabled가 true일 때 이 키에서 허용되는 쉼표로 구분된 model ID입니다. 비어 있으면 구성된 model 목록이 없음을 의미합니다. |
allow_ips | string or null | 한 줄로 구분된 문자열 형태의 IP 허용 목록입니다. 각 항목은 단일 IPv4 주소, 단일 IPv6 주소, IPv4 CIDR 또는 IPv6 CIDR일 수 있습니다. null 또는 ""은 IP 제한이 없음을 의미합니다. |
group | string | 계정 그룹 제한입니다. 비어 있으면 명시적인 그룹 제한이 없음을 의미합니다. |
cross_group_retry | boolean | 자동 그룹 라우팅에서 교차 그룹 재시도가 활성화되어 있는지 여부입니다. |
인증
Personal access token copied from CometAPI Console > Personal Settings. Send the raw token value; do not prefix it with Bearer.
경로 매개변수
Numeric API key ID returned by the list endpoint.