Обновить API key
Обновите API key CometAPI, передав ID ключа и редактируемые поля в теле JSON.
Используйте этот endpoint, чтобы обновить имя API key, статус, квоту, срок действия, ограничения по моделям, список разрешённых IP-адресов и настройки группы.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.
Authorization. Не добавляйте префикс Bearer.Тело запроса
| Field | Type | Description |
|---|---|---|
id | integer | Обязательно. ID API key, возвращаемый методом List API keys. |
name | string | Понятное пользователю отображаемое имя ключа. Должно содержать не более 50 символов. |
status | integer | Рабочий статус. 1 включает ключ для запросов к моделям. 2 отключает его. 3 помечает его как истёкший. 4 помечает, что квота исчерпана. Отключённые, истёкшие или исчерпавшие квоту ключи отклоняются endpoint’ами моделей. |
expired_time | integer | Unix timestamp в секундах, когда срок действия ключа истекает. Используйте -1, если срок действия не ограничен. Timestamp в прошлом блокирует запросы к моделям. |
remain_quota | integer | Оставшаяся квота во внутренних единицах квоты CometAPI. Если это значение достигает 0 и unlimited_quota равно false, запросы к моделям с этим ключом отклоняются как исчерпавшие квоту. |
unlimited_quota | boolean | Указывает, должен ли ключ обходить проверки оставшейся квоты. Устанавливайте true только в том случае, если ключ должен продолжать работать, даже когда remain_quota равно 0. |
model_limits_enabled | boolean | Указывает, нужно ли ограничивать этот ключ определёнными моделями. Когда значение false, model_limits игнорируется. |
model_limits | string | Разделённые запятыми model ID, разрешённые для этого ключа, когда model_limits_enabled равно true. Используйте model ID, возвращаемые /v1/models; используйте пустую строку, если ограничения по моделям не нужны. |
allow_ips | string or null | Необязательный список разрешённых IP-адресов. Передайте одну JSON-строку с записями, разделёнными символами новой строки (\n). Каждая запись может быть отдельным IPv4-адресом, отдельным IPv6-адресом, IPv4 CIDR или IPv6 CIDR. Используйте null или "", чтобы отключить ограничения по IP. |
group | string | Необязательное ограничение по группе аккаунта. Используйте пустую строку, если явная группа не требуется. Непустые значения должны быть доступны аккаунту, иначе API вернёт success: false. |
cross_group_retry | boolean | Указывает, включён ли межгрупповой повторный запрос для автоматической маршрутизации по группам. Имеет смысл только тогда, когда ключ использует группу с автоматической маршрутизацией. |
Формат списка разрешённых адресов
Чтобы разрешить несколько IP-адресов или диапазонов CIDR, передайте их как одну JSON-строку, используя\n между записями:
Авторизации
Personal access token copied from CometAPI Console > Personal Settings. Send the raw token value; do not prefix it with Bearer.
Тело
Numeric API key ID returned by the list endpoint. For updates, send this value in the JSON body, not in the URL.
1234
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.
50"production"
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.
1, 2, 3, 4 1
Unix timestamp in seconds when the key expires. Use -1 for no expiration. A past timestamp blocks model requests with this key.
-1
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.
100000
Whether the key bypasses remaining-quota checks. Set true only when the key should keep working even if remain_quota is 0.
false
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
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.
""
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"
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.
""
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