Passer au contenu 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.

Utilisez ce endpoint pour créer une clé API destinée à l’automatisation, à des tableaux de bord internes ou à des intégrations côté serveur.
Générez un personal access token dans Console → Personal Settings, puis envoyez-le comme valeur brute de l’en-tête Authorization. Ne le préfixez pas avec Bearer.
La réponse de création confirme uniquement le succès. Elle n’inclut ni le nouvel enregistrement de clé ni la valeur de la clé. Après la création, appelez List API keys pour lire l’enregistrement de clé le plus récent.

​
Corps de la requête

FieldTypeDescription
namestringNom d’affichage lisible par l’utilisateur pour la clé. Doit comporter 50 caractères ou moins.
expired_timeintegerHorodatage Unix en secondes indiquant quand la clé expire. Utilisez -1 pour aucune expiration.
remain_quotaintegerQuota initial en unités de quota internes CometAPI. Si cette valeur atteint 0 et que unlimited_quota vaut false, les requêtes de modèle avec cette clé sont rejetées pour quota épuisé.
unlimited_quotabooleanIndique si la clé contourne les vérifications de quota restant. Définissez true uniquement si la clé doit continuer à fonctionner même si remain_quota vaut 0.
model_limits_enabledbooleanIndique s’il faut restreindre cette clé à des modèles spécifiques. Lorsque false, model_limits est ignoré.
model_limitsstringmodel ID séparés par des virgules et autorisés par cette clé lorsque model_limits_enabled vaut true. Utilisez les model ID renvoyés par /v1/models ; utilisez une chaîne vide pour aucune restriction de modèle.
allow_ipsstring or nullListe d’autorisation d’IP facultative. Fournissez une chaîne JSON contenant des entrées séparées par des sauts de ligne (\n). Chaque entrée peut être une adresse IPv4 unique, une adresse IPv6 unique, un CIDR IPv4 ou un CIDR IPv6. Utilisez null ou "" pour désactiver les restrictions d’IP.
groupstringRestriction facultative à un groupe de compte. Utilisez une chaîne vide pour ne définir aucun groupe explicite. Les valeurs non vides doivent être disponibles pour le compte, sinon l’API renvoie success: false.
cross_group_retrybooleanIndique si la nouvelle tentative inter-groupe est activée pour le routage automatique des groupes. Cela n’a de sens que lorsque la clé utilise un groupe à routage automatique.

​
Format de la liste d’autorisation

Pour autoriser plusieurs IP ou plages CIDR, envoyez-les sous la forme d’une seule chaîne JSON avec \n entre les entrées : 
{
  "allow_ips": "198.51.100.10\n203.0.113.0/24\n2001:db8::/32"
}
Cet exemple autorise une adresse IPv4, une plage CIDR IPv4 et une plage CIDR IPv6.

Autorisations

​
Authorization
string
header
requis

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

Corps

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

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

Exemple:

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

Exemple:

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.

Exemple:

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.

Exemple:

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.

Exemple:

""

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

Exemple:

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

Exemple:

""

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

Exemple:

false

Réponse

200 - application/json

Create result.

​
success
boolean
requis

Whether the create operation succeeded.

Exemple:

true

​
message
string
requis

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

Exemple:

""