Przejdź do głównej treści
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.

Użyj tego endpointu, aby utworzyć klucz API do automatyzacji, wewnętrznych dashboardów lub integracji po stronie serwera.
Wygeneruj personal access token w Console → Personal Settings, a następnie wyślij go jako surową wartość nagłówka Authorization. Nie poprzedzaj go prefiksem Bearer.
Odpowiedź create potwierdza tylko powodzenie operacji. Nie zawiera nowego rekordu klucza ani wartości klucza. Po utworzeniu wywołaj List API keys, aby odczytać najnowszy rekord klucza.

​
Treść żądania

FieldTypeDescription
namestringCzytelna dla użytkownika nazwa wyświetlana klucza. Musi mieć maksymalnie 50 znaków.
expired_timeintegerZnacznik czasu Unix w sekundach określający moment wygaśnięcia klucza. Użyj -1, aby ustawić brak wygaśnięcia.
remain_quotaintegerPoczątkowy limit w wewnętrznych jednostkach limitu CometAPI. Jeśli ta wartość osiągnie 0, a unlimited_quota ma wartość false, żądania do modeli z tym kluczem zostaną odrzucone z powodu wyczerpania limitu.
unlimited_quotabooleanOkreśla, czy klucz pomija sprawdzanie pozostałego limitu. Ustaw true tylko wtedy, gdy klucz ma nadal działać, nawet jeśli remain_quota wynosi 0.
model_limits_enabledbooleanOkreśla, czy ograniczyć ten klucz do określonych modeli. Gdy ma wartość false, model_limits jest ignorowane.
model_limitsstringRozdzielona przecinkami lista model ID dozwolonych dla tego klucza, gdy model_limits_enabled ma wartość true. Użyj model ID zwracanych przez /v1/models; użyj pustego ciągu, aby nie stosować ograniczeń modeli.
allow_ipsstring or nullOpcjonalna lista dozwolonych adresów IP. Podaj jeden ciąg JSON z wpisami rozdzielonymi znakami nowej linii (\n). Każdy wpis może być pojedynczym adresem IPv4, pojedynczym adresem IPv6, zakresem IPv4 CIDR lub zakresem IPv6 CIDR. Użyj null lub "", aby wyłączyć ograniczenia IP.
groupstringOpcjonalne ograniczenie do grupy konta. Użyj pustego ciągu, aby nie ustawiać jawnej grupy. Wartości niepuste muszą być dostępne dla konta, w przeciwnym razie API zwróci success: false.
cross_group_retrybooleanOkreśla, czy włączono ponawianie między grupami dla automatycznego routingu grup. Ma to znaczenie tylko wtedy, gdy klucz używa grupy z automatycznym routingiem.

​
Format allowlisty

Aby zezwolić na wiele adresów IP lub zakresów CIDR, wyślij je jako jeden ciąg JSON z \n między wpisami: 
{
  "allow_ips": "198.51.100.10\n203.0.113.0/24\n2001:db8::/32"
}
Ten przykład zezwala na jeden adres IPv4, jeden zakres IPv4 CIDR i jeden zakres IPv6 CIDR.

Autoryzacje

​
Authorization
string
header
wymagane

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

Treść

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
Przykład:

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

Przykład:

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

Przykład:

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.

Przykład:

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.

Przykład:

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.

Przykład:

""

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

Przykład:

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

Przykład:

""

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

Przykład:

false

Odpowiedź

200 - application/json

Create result.

​
success
boolean
wymagane

Whether the create operation succeeded.

Przykład:

true

​
message
string
wymagane

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

Przykład:

""