Criar uma API key

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

Use este endpoint para criar uma API key para automação, dashboards internos ou integrações do 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 adicione o prefixo Bearer.

A resposta de criação apenas confirma o sucesso. Ela não inclui o novo registro da key nem o valor da key. Após a criação, chame List API keys para ler o registro da key mais recente.

Corpo da requisição

Field	Type	Description
`name`	string	Nome de exibição legível pelo usuário para a key. Deve ter 50 caracteres ou menos.
`expired_time`	integer	Timestamp Unix em segundos indicando quando a key expira. Use `-1` para sem expiração.
`remain_quota`	integer	Quota inicial em unidades internas de quota do CometAPI. Se isso atingir `0` e `unlimited_quota` for `false`, as requisições de modelo com esta key serão rejeitadas por quota esgotada.
`unlimited_quota`	boolean	Indica se a key ignora as verificações de quota restante. Defina como `true` apenas quando a key deve continuar funcionando mesmo se `remain_quota` for `0`.
`model_limits_enabled`	boolean	Indica se esta key deve ser restrita a modelos específicos. Quando `false`, `model_limits` é ignorado.
`model_limits`	string	model IDs separados por vírgula permitidos por esta key quando `model_limits_enabled` for `true`. Use os model IDs retornados por `/v1/models`; use uma string vazia para nenhuma restrição de modelo.
`allow_ips`	string or null	Lista de IPs permitidos opcional. Forneça uma string JSON com entradas separadas por quebras de 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.
`group`	string	Restriçã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 retorna `success: false`.
`cross_group_retry`	boolean	Indica se a nova tentativa entre grupos está habilitada para roteamento automático de grupos. Isso só faz sentido quando a key usa um grupo com roteamento automático.

Formato da allowlist

Para permitir vários IPs ou intervalos CIDR, envie-os como uma 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:

""

Listar chaves de API

Recuperar uma chave de API

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

Moderação de conteúdo

Chaves de API

Corpo da requisição

Formato da allowlist

Autorizações

Corpo

Resposta

​Corpo da requisição

​Formato da allowlist

Autorizações

Corpo

Resposta

Corpo da requisição

Formato da allowlist