Hopp til hovedinnhold
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.

Bruk dette endepunktet til å opprette en API-nøkkel for automatisering, interne dashbord eller integrasjoner på serversiden.
Generer et personal access token i Console → Personal Settings, og send det deretter som den rå Authorization header-verdien. Ikke legg til prefikset Bearer.
Opprettelsessvaret bekrefter bare at operasjonen var vellykket. Det inkluderer ikke den nye nøkkeloppføringen eller nøkkelverdien. Etter opprettelse kan du kalle List API keys for å lese den nyeste nøkkeloppføringen.

​
Request body

FieldTypeDescription
namestringLesbart visningsnavn for nøkkelen. Må være 50 tegn eller færre.
expired_timeintegerUnix-tidsstempel i sekunder for når nøkkelen utløper. Bruk -1 for ingen utløpstid.
remain_quotaintegerStartkvote i CometAPI interne kvoteenheter. Hvis denne når 0 og unlimited_quota er false, blir model-forespørsler med denne nøkkelen avvist fordi kvoten er brukt opp.
unlimited_quotabooleanOm nøkkelen skal omgå kontroller av gjenværende kvote. Sett true bare når nøkkelen skal fortsette å fungere selv om remain_quota er 0.
model_limits_enabledbooleanOm denne nøkkelen skal begrenses til bestemte modeller. Når false, ignoreres model_limits.
model_limitsstringKommaseparerte model ID-er som er tillatt for denne nøkkelen når model_limits_enabled er true. Bruk model ID-er returnert av /v1/models; bruk en tom streng for ingen modellbegrensning.
allow_ipsstring or nullValgfri IP-tillatelsesliste. Oppgi én JSON-streng med oppføringer separert av linjeskifttegn (\n). Hver oppføring kan være én enkelt IPv4-adresse, én enkelt IPv6-adresse, IPv4 CIDR eller IPv6 CIDR. Bruk null eller "" for å deaktivere IP-begrensninger.
groupstringValgfri begrensning til kontogruppe. Bruk en tom streng for ingen eksplisitt gruppe. Ikke-tomme verdier må være tilgjengelige for kontoen, ellers returnerer API-et success: false.
cross_group_retrybooleanOm retry på tvers av grupper er aktivert for automatisk grupperuting. Dette er bare meningsfullt når nøkkelen bruker en gruppe med automatisk ruting.

​
Tillatelseslisteformat

For å tillate flere IP-er eller CIDR-områder, send dem som én JSON-streng med \n mellom oppføringene: 
{
  "allow_ips": "198.51.100.10\n203.0.113.0/24\n2001:db8::/32"
}
Dette eksemplet tillater én IPv4-adresse, ett IPv4 CIDR-område og ett IPv6 CIDR-område.

Autorisasjoner

​
Authorization
string
header
påkrevd

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

Kropp

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

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

Eksempel:

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

Eksempel:

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.

Eksempel:

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.

Eksempel:

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.

Eksempel:

""

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

Eksempel:

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

Eksempel:

""

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

Eksempel:

false

Svar

200 - application/json

Create result.

​
success
boolean
påkrevd

Whether the create operation succeeded.

Eksempel:

true

​
message
string
påkrevd

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

Eksempel:

""