API 키
API 키 목록
인증된 계정의 CometAPI API 키를 페이지네이션과 함께 나열합니다.
GET
cURL
이 엔드포인트를 사용해 인증된 CometAPI 계정에 속한 API 키를 나열합니다. 가장 최근 키가 먼저 반환됩니다.
Console → Personal Settings에서 personal access token을 생성한 다음, 이를 원시
Authorization 헤더 값으로 전송하세요. 앞에 Bearer를 붙이지 마세요.페이지네이션
| Query parameter | Description |
|---|---|
p | 페이지 번호입니다. 기본값은 1입니다. |
page_size | 페이지당 항목 수입니다. 100을 초과하면 100으로 제한됩니다. |
API 키 상태
| Status | Meaning |
|---|---|
1 | 활성화됨 |
2 | 비활성화됨 |
3 | 만료됨 |
4 | 소진됨 |
반환 필드
| Field | Type | Description |
|---|---|---|
id | integer | 숫자 형태의 API 키 ID입니다. 이 값을 Get a single API key, Update an API key, Delete an API key와 함께 사용하세요. |
key | string | 관리 API가 반환하는 API 키 값입니다. 비밀로 취급하고 모델 요청에는 Authorization: Bearer $COMETAPI_KEY로 사용하세요. |
status | integer | 운영 상태입니다. 1만 모델 요청에 대해 키가 활성화되어 있음을 의미합니다. |
name | string | 키의 사람이 읽을 수 있는 표시 이름입니다. |
created_time | integer | 키가 생성된 시점의 Unix timestamp(초)입니다. |
accessed_time | integer | 키가 마지막으로 사용된 시점의 Unix timestamp(초)입니다. |
expired_time | integer | 키가 만료되는 시점의 Unix timestamp(초)입니다. -1은 만료되지 않음을 의미합니다. |
remain_quota | integer | CometAPI 내부 quota 단위로 남아 있는 quota입니다. |
used_quota | integer | CometAPI 내부 quota 단위로 이 키가 이미 사용한 quota입니다. |
unlimited_quota | boolean | 키가 남은 quota 검사에서 제외되는지 여부입니다. |
model_limits_enabled | boolean | 이 키에 대해 모델 제한이 활성화되어 있는지 여부입니다. |
model_limits | string | model_limits_enabled가 true일 때 이 키에서 허용되는 쉼표로 구분된 model ID입니다. 비어 있으면 구성된 모델 목록이 없음을 의미합니다. |
allow_ips | string or null | 하나의 줄바꿈으로 구분된 문자열 형태의 IP allowlist입니다. 각 항목은 단일 IPv4 주소, 단일 IPv6 주소, IPv4 CIDR 또는 IPv6 CIDR일 수 있습니다. null 또는 ""은 IP 제한이 없음을 의미합니다. |
group | string | 계정 그룹 제한입니다. 비어 있으면 명시적인 그룹 제한이 없음을 의미합니다. |
cross_group_retry | boolean | 자동 그룹 라우팅에서 cross-group retry가 활성화되어 있는지 여부입니다. |
인증
Personal access token copied from CometAPI Console > Personal Settings. Send the raw token value; do not prefix it with Bearer.
쿼리 매개변수
Page number to return. Defaults to 1.
필수 범위:
x >= 1Number of keys per page. Values above 100 are capped at 100 by the backend.
필수 범위:
1 <= x <= 100