메인 콘텐츠로 건너뛰기
POST
/
api
/
token
curl https://api.cometapi.com/api/token/ \
  -H "Authorization: your-access-token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "production",
    "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": ""
}

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 키를 생성할 수 있습니다.
Console → Personal Settings에서 personal access token을 생성한 다음, 이를 원시 Authorization 헤더 값으로 전송하세요. Bearer 접두사는 붙이지 마세요.
생성 응답은 성공만 확인해 줍니다. 새 키 레코드나 키 값은 포함되지 않습니다. 생성 후에는 List API keys를 호출하여 가장 최신 키 레코드를 조회하세요.

​
요청 본문

FieldTypeDescription
namestring키의 사용자 친화적인 표시 이름입니다. 50자 이하여야 합니다.
expired_timeinteger키가 만료되는 시점의 Unix 타임스탬프(초)입니다. 만료 없음은 -1을 사용하세요.
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선택적 계정 group 제한입니다. 명시적 group이 없으면 빈 문자열을 사용하세요. 비어 있지 않은 값은 계정에서 사용 가능해야 하며, 그렇지 않으면 API는 success: false를 반환합니다.
cross_group_retryboolean자동 group 라우팅을 위해 cross-group retry가 활성화되어 있는지 여부입니다. 이는 키가 자동 라우팅되는 group을 사용할 때만 의미가 있습니다.

​
허용 목록 형식

여러 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 copied from CometAPI Console > Personal Settings. Send the raw token value; do not prefix it with Bearer.

본문

application/json
​
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"

​
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

Starting quota for the new 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

Create result.

​
success
boolean
필수

Whether the create operation succeeded.

예시:

true

​
message
string
필수

Backend status message. The value is usually an empty string on success.

예시:

""