Przejdź do głównej treści
PUT
/
api
/
token
curl -X PUT https://api.cometapi.com/api/token/ \
  -H "Authorization: your-access-token" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 1234,
    "name": "production-renamed",
    "status": 1,
    "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": "",
  "data": {
    "id": 1234,
    "user_id": 5678,
    "key": "<COMETAPI_KEY>",
    "status": 1,
    "name": "production-renamed",
    "created_time": 1766102400,
    "accessed_time": 1766102400,
    "expired_time": -1,
    "remain_quota": 100000,
    "unlimited_quota": false,
    "model_limits_enabled": false,
    "model_limits": "",
    "allow_ips": null,
    "used_quota": 0,
    "group": "",
    "cross_group_retry": false
  }
}

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 zaktualizować nazwę klucza API, status, limit, datę wygaśnięcia, ograniczenia modeli, listę dozwolonych adresów IP oraz ustawienia grupy.
Wygeneruj personal access token w Console → Personal Settings, a następnie wyślij go jako surową wartość nagłówka Authorization. Nie dodawaj prefiksu Bearer.
Ten endpoint używa PUT /api/token/, a id należy umieścić w treści JSON. Wyślij edytowalne pola, które chcesz zachować; pominięte pola numeryczne, logiczne lub tekstowe mogą zostać zresetowane przez aktualizację.

​
Treść żądania

FieldTypeDescription
idintegerWymagane. ID klucza API zwrócone przez List API keys.
namestringCzytelna dla użytkownika nazwa wyświetlana klucza. Musi mieć maksymalnie 50 znaków.
statusintegerStatus operacyjny. 1 włącza klucz dla żądań modeli. 2 wyłącza go. 3 oznacza go jako wygasły. 4 oznacza wyczerpanie limitu. Klucze wyłączone, wygasłe lub z wyczerpanym limitem są odrzucane przez endpointy modeli.
expired_timeintegerZnacznik czasu Unix w sekundach określający moment wygaśnięcia klucza. Użyj -1, aby ustawić brak wygaśnięcia. Znacznik czasu z przeszłości blokuje żądania modeli.
remain_quotaintegerPozostały limit w wewnętrznych jednostkach limitu CometAPI. Jeśli ta wartość osiągnie 0, a unlimited_quota ma wartość false, żądania modeli z tym kluczem będą odrzucane jako limit wyczerpany.
unlimited_quotabooleanOkreśla, czy klucz pomija sprawdzanie pozostałego limitu. Ustaw true tylko wtedy, gdy klucz ma nadal działać nawet wtedy, gdy 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żywaj model ID zwróconych 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, jeśli nie ma być ustawiona jawna grupa. Niepuste wartości muszą być dostępne dla konta, w przeciwnym razie API zwróci success: false.
cross_group_retrybooleanOkreśla, czy włączone jest ponawianie między grupami dla automatycznego routingu grup. Ma to znaczenie tylko wtedy, gdy klucz używa grupy z automatycznym routingiem.

​
Format listy dozwolonych adresów

Aby zezwolić na wiele adresów IP lub zakresów CIDR, wyślij je jako jeden ciąg JSON z \n pomię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
​
id
integer
wymagane

Numeric API key ID returned by the list endpoint. For updates, send this value in the JSON body, not in the URL.

Przykład:

1234

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

​
status
enum<integer>

Operational status for the key. 1 enables the key for model requests, 2 disables it, 3 marks it expired, and 4 marks it quota exhausted. Disabled, expired, or exhausted keys are rejected by model endpoints.

Dostępne opcje:
1,
2,
3,
4
Przykład:

1

​
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

Remaining quota to assign to the 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

Updated API key record.

​
success
boolean
wymagane
​
message
string
wymagane
​
data
object
wymagane