Ana içeriğe atla
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.

Otomasyon, dahili panolar veya sunucu tarafı entegrasyonları için bir API anahtarı oluşturmak üzere bu endpoint’i kullanın.
Console → Personal Settings bölümünde bir personal access token oluşturun, ardından bunu ham Authorization başlık değeri olarak gönderin. Başına Bearer eklemeyin.
Oluşturma yanıtı yalnızca başarılı olduğunu doğrular. Yeni anahtar kaydını veya anahtar değerini içermez. Oluşturduktan sonra, en yeni anahtar kaydını okumak için API anahtarlarını listeleyin çağrısını yapın.

​
İstek gövdesi

FieldTypeDescription
namestringAnahtar için kullanıcı tarafından okunabilir görünen ad. 50 karakter veya daha kısa olmalıdır.
expired_timeintegerAnahtarın süresinin dolacağı saniye cinsinden Unix timestamp. Süresiz olması için -1 kullanın.
remain_quotaintegerCometAPI dahili kota birimlerinde başlangıç kotası. Bu değer 0 olursa ve unlimited_quota false ise, bu anahtarla yapılan model istekleri kota tükendiği için reddedilir.
unlimited_quotabooleanAnahtarın kalan kota kontrollerini atlayıp atlamayacağı. Anahtarın remain_quota 0 olsa bile çalışmaya devam etmesi gerekiyorsa yalnızca true olarak ayarlayın.
model_limits_enabledbooleanBu anahtarın belirli modellerle sınırlandırılıp sınırlandırılmayacağı. false olduğunda model_limits yok sayılır.
model_limitsstringmodel_limits_enabled true olduğunda bu anahtarın izin verdiği, virgülle ayrılmış model ID listesi. /v1/models tarafından döndürülen model ID’leri kullanın; model kısıtlaması olmaması için boş string kullanın.
allow_ipsstring or nullİsteğe bağlı IP izin listesi. Girdileri yeni satır karakterleriyle (\n) ayrılmış tek bir JSON string olarak sağlayın. Her girdi tek bir IPv4 adresi, tek bir IPv6 adresi, IPv4 CIDR veya IPv6 CIDR olabilir. IP kısıtlamalarını devre dışı bırakmak için null veya "" kullanın.
groupstringİsteğe bağlı hesap grubu kısıtlaması. Açık bir grup olmaması için boş string kullanın. Boş olmayan değerler hesap için kullanılabilir olmalıdır, aksi takdirde API success: false döndürür.
cross_group_retrybooleanOtomatik grup yönlendirmesi için gruplar arası yeniden denemenin etkin olup olmayacağı. Bu yalnızca anahtar otomatik yönlendirilen bir grup kullandığında anlamlıdır.

​
İzin listesi biçimi

Birden fazla IP veya CIDR aralığına izin vermek için, bunları girdiler arasında \n olacak şekilde tek bir JSON string olarak gönderin: 
{
  "allow_ips": "198.51.100.10\n203.0.113.0/24\n2001:db8::/32"
}
Bu örnek bir IPv4 adresine, bir IPv4 CIDR aralığına ve bir IPv6 CIDR aralığına izin verir.

Yetkilendirmeler

​
Authorization
string
header
gerekli

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

Gövde

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
Örnek:

"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.

Örnek:

-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.

Örnek:

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.

Örnek:

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.

Örnek:

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.

Örnek:

""

​
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.

Örnek:

"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.

Örnek:

""

​
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.

Örnek:

false

Yanıt

200 - application/json

Create result.

​
success
boolean
gerekli

Whether the create operation succeeded.

Örnek:

true

​
message
string
gerekli

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

Örnek:

""