Saltar para o conteúdo principal
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.

Use este endpoint para criar uma chave de API para automação, painéis internos ou integrações no lado do servidor.
Gere um personal access token em Console → Personal Settings e, em seguida, envie-o como o valor bruto do cabeçalho Authorization. Não prefixe com Bearer.
A resposta de criação apenas confirma o sucesso. Ela não inclui o registro da nova chave nem o valor da chave. Após a criação, chame List API keys para ler o registro da chave mais recente.

​
Corpo da requisição

FieldTypeDescription
namestringNome de exibição legível pelo usuário para a chave. Deve ter 50 caracteres ou menos.
expired_timeintegerTimestamp Unix em segundos indicando quando a chave expira. Use -1 para sem expiração.
remain_quotaintegerCota inicial em unidades internas de cota do CometAPI. Se isso chegar a 0 e unlimited_quota for false, requisições de model com esta chave serão rejeitadas por cota esgotada.
unlimited_quotabooleanSe a chave ignora as verificações de cota restante. Defina true somente quando a chave deve continuar funcionando mesmo se remain_quota for 0.
model_limits_enabledbooleanSe esta chave deve ser restrita a modelos específicos. Quando false, model_limits é ignorado.
model_limitsstringmodel IDs separados por vírgula permitidos por esta chave quando model_limits_enabled for true. Use os model IDs retornados por /v1/models; use uma string vazia para nenhuma restrição de model.
allow_ipsstring or nullAllowlist de IP opcional. Forneça uma string JSON com entradas separadas por caracteres de nova linha (\n). Cada entrada pode ser um único endereço IPv4, um único endereço IPv6, um CIDR IPv4 ou um CIDR IPv6. Use null ou "" para desativar as restrições de IP.
groupstringRestrição opcional de grupo da conta. Use uma string vazia para nenhum grupo explícito. Valores não vazios devem estar disponíveis para a conta, ou a API retornará success: false.
cross_group_retrybooleanSe a repetição entre grupos está habilitada para roteamento automático de grupos. Isso só faz sentido quando a chave usa um grupo com roteamento automático.

​
Formato da allowlist

Para permitir vários IPs ou intervalos CIDR, envie-os como uma única string JSON com \n entre as entradas: 
{
  "allow_ips": "198.51.100.10\n203.0.113.0/24\n2001:db8::/32"
}
Este exemplo permite um endereço IPv4, um intervalo CIDR IPv4 e um intervalo CIDR IPv6.

Autorizações

​
Authorization
string
header
obrigatório

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

Corpo

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
Exemplo:

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

Exemplo:

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

Exemplo:

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.

Exemplo:

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.

Exemplo:

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.

Exemplo:

""

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

Exemplo:

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

Exemplo:

""

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

Exemplo:

false

Resposta

200 - application/json

Create result.

​
success
boolean
obrigatório

Whether the create operation succeeded.

Exemplo:

true

​
message
string
obrigatório

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

Exemplo:

""