Vai al contenuto principale
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.

Usa questo endpoint per creare una API key per automazione, dashboard interne o integrazioni lato server.
Genera un personal access token in Console → Personal Settings, quindi invialo come valore grezzo dell’header Authorization. Non anteporre Bearer.
La risposta di creazione conferma solo l’operazione riuscita. Non include il record della nuova chiave né il valore della chiave. Dopo la creazione, chiama List API keys per leggere il record della chiave più recente.

​
Corpo della richiesta

FieldTypeDescription
namestringNome visualizzato leggibile dall’utente per la chiave. Deve essere lungo al massimo 50 caratteri.
expired_timeintegerTimestamp Unix in secondi in cui la chiave scade. Usa -1 per nessuna scadenza.
remain_quotaintegerQuota iniziale nelle unità di quota interne di CometAPI. Se raggiunge 0 e unlimited_quota è false, le richieste al model con questa chiave vengono rifiutate perché la quota è esaurita.
unlimited_quotabooleanIndica se la chiave ignora i controlli sulla quota residua. Imposta true solo quando la chiave deve continuare a funzionare anche se remain_quota è 0.
model_limits_enabledbooleanIndica se limitare questa chiave a model specifici. Quando è false, model_limits viene ignorato.
model_limitsstringmodel ID separati da virgole consentiti da questa chiave quando model_limits_enabled è true. Usa i model ID restituiti da /v1/models; usa una stringa vuota per nessuna limitazione dei model.
allow_ipsstring or nullAllowlist IP opzionale. Fornisci una stringa JSON con le voci separate da caratteri di nuova riga (\n). Ogni voce può essere un singolo indirizzo IPv4, un singolo indirizzo IPv6, un CIDR IPv4 o un CIDR IPv6. Usa null o "" per disattivare le restrizioni IP.
groupstringRestrizione opzionale al gruppo dell’account. Usa una stringa vuota per nessun gruppo esplicito. I valori non vuoti devono essere disponibili per l’account, altrimenti l’API restituisce success: false.
cross_group_retrybooleanIndica se il retry cross-group è abilitato per il routing automatico del gruppo. Questo ha senso solo quando la chiave usa un gruppo con instradamento automatico.

​
Formato dell’allowlist

Per consentire più IP o intervalli CIDR, inviali come un’unica stringa JSON con \n tra le voci: 
{
  "allow_ips": "198.51.100.10\n203.0.113.0/24\n2001:db8::/32"
}
Questo esempio consente un indirizzo IPv4, un intervallo CIDR IPv4 e un intervallo CIDR IPv6.

Autorizzazioni

​
Authorization
string
header
obbligatorio

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

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

Esempio:

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

Esempio:

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.

Esempio:

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.

Esempio:

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.

Esempio:

""

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

Esempio:

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

Esempio:

""

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

Esempio:

false

Risposta

200 - application/json

Create result.

​
success
boolean
obbligatorio

Whether the create operation succeeded.

Esempio:

true

​
message
string
obbligatorio

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

Esempio:

""