Utwórz klucz API

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": ""
}

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ź tworzenia potwierdza jedynie 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

Field	Type	Description
`name`	string	Czytelna dla użytkownika nazwa wyświetlana klucza. Musi mieć maksymalnie 50 znaków.
`expired_time`	integer	Znacznik czasu Unix w sekundach określający moment wygaśnięcia klucza. Użyj `-1`, aby ustawić brak wygaśnięcia.
`remain_quota`	integer	Początkowy limit w wewnętrznych jednostkach limitu CometAPI. Jeśli osiągnie `0`, a `unlimited_quota` ma wartość `false`, żądania do modeli z użyciem tego klucza zostaną odrzucone z powodu wyczerpania limitu.
`unlimited_quota`	boolean	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_enabled`	boolean	Czy ograniczyć ten klucz do określonych modeli. Gdy ma wartość `false`, `model_limits` jest ignorowane.
`model_limits`	string	Rozdzielona przecinkami lista model ID dozwolonych dla tego klucza, gdy `model_limits_enabled` ma wartość `true`. Używaj model ID zwracanych przez `/v1/models`; użyj pustego ciągu, aby nie stosować ograniczenia modeli.
`allow_ips`	string or null	Opcjonalna lista dozwolonych adresów IP. Przekaż 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.
`group`	string	Opcjonalne ograniczenie do grupy konta. Użyj pustego ciągu, jeśli nie ma jawnie określonej grupy. Wartości niepuste muszą być dostępne dla konta, w przeciwnym razie API zwróci `success: false`.
`cross_group_retry`	boolean	Czy włączono ponawianie między grupami na potrzeby automatycznego routingu grup. Ma to znaczenie tylko wtedy, gdy klucz używa grupy z automatycznym routingiem.

Format listy dozwolonych adresów

Aby dopuścić 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 dopuszcza 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:

""

Wyświetlanie kluczy API

Poprzedni

Pobierz klucz API

Następny

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": ""
}

Moderacja treści

Klucze API

Treść żądania

Format listy dozwolonych adresów

Autoryzacje

Treść

Odpowiedź

​Treść żądania

​Format listy dozwolonych adresów

Autoryzacje

Treść

Odpowiedź

Treść żądania

Format listy dozwolonych adresów