Saltar al contenido 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.

Usa este endpoint para crear una API key para automatización, paneles internos o integraciones del lado del servidor.
Genera un personal access token en Console → Personal Settings, luego envíalo como el valor sin procesar del encabezado Authorization. No le antepongas Bearer.
La respuesta de creación solo confirma que la operación fue exitosa. No incluye el nuevo registro de la key ni el valor de la key. Después de crearla, llama a List API keys para leer el registro de la key más reciente.

​
Cuerpo de la solicitud

FieldTypeDescription
namestringNombre para mostrar legible por el usuario para la key. Debe tener 50 caracteres o menos.
expired_timeintegerMarca de tiempo Unix en segundos en la que expira la key. Usa -1 para que no expire.
remain_quotaintegerCuota inicial en unidades internas de cuota de CometAPI. Si esto llega a 0 y unlimited_quota es false, las solicitudes al modelo con esta key se rechazan por cuota agotada.
unlimited_quotabooleanIndica si la key omite las verificaciones de cuota restante. Establece true solo cuando la key deba seguir funcionando incluso si remain_quota es 0.
model_limits_enabledbooleanIndica si se debe restringir esta key a modelos específicos. Cuando es false, model_limits se ignora.
model_limitsstringmodel ID separados por comas permitidos por esta key cuando model_limits_enabled es true. Usa los model ID devueltos por /v1/models; usa una cadena vacía para no aplicar restricciones de modelo.
allow_ipsstring or nullLista de IP permitidas opcional. Proporciona una cadena JSON con las entradas separadas por saltos de línea (\n). Cada entrada puede ser una dirección IPv4 individual, una dirección IPv6 individual, un CIDR IPv4 o un CIDR IPv6. Usa null o "" para desactivar las restricciones de IP.
groupstringRestricción opcional al grupo de la cuenta. Usa una cadena vacía si no quieres un grupo explícito. Los valores no vacíos deben estar disponibles para la cuenta; de lo contrario, la API devuelve success: false.
cross_group_retrybooleanIndica si el reintento entre grupos está habilitado para el enrutamiento automático de grupos. Esto solo tiene sentido cuando la key usa un grupo con enrutamiento automático.

​
Formato de la lista de permitidos

Para permitir múltiples IP o rangos CIDR, envíalos como una sola cadena JSON con \n entre las entradas: 
{
  "allow_ips": "198.51.100.10\n203.0.113.0/24\n2001:db8::/32"
}
Este ejemplo permite una dirección IPv4, un rango CIDR IPv4 y un rango CIDR IPv6.

Autorizaciones

​
Authorization
string
header
requerido

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

Cuerpo

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

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

Ejemplo:

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

Ejemplo:

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.

Ejemplo:

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.

Ejemplo:

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.

Ejemplo:

""

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

Ejemplo:

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

Ejemplo:

""

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

Ejemplo:

false

Respuesta

200 - application/json

Create result.

​
success
boolean
requerido

Whether the create operation succeeded.

Ejemplo:

true

​
message
string
requerido

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

Ejemplo:

""