Maak een API-sleutel aan - CometAPI Documentation

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

Gebruik deze endpoint om een API-sleutel aan te maken voor automatisering, interne dashboards of server-side integraties.

Genereer een personal access token via Console → Personal Settings en stuur het vervolgens als de ruwe Authorization-headerwaarde. Voeg er geen Bearer-prefix aan toe.

De create-respons bevestigt alleen succes. Deze bevat niet de nieuwe sleutelrecord of sleutelwaarde. Roep na het aanmaken List API keys aan om de nieuwste sleutelrecord op te halen.

Request body

Field	Type	Description
`name`	string	Voor gebruikers leesbare weergavenaam voor de sleutel. Moet 50 tekens of minder zijn.
`expired_time`	integer	Unix-timestamp in seconden waarop de sleutel verloopt. Gebruik `-1` voor geen vervaldatum.
`remain_quota`	integer	Startquotum in interne quotumeenheden van CometAPI. Als dit `0` bereikt en `unlimited_quota` `false` is, worden modelaanvragen met deze sleutel afgewezen omdat het quotum is uitgeput.
`unlimited_quota`	boolean	Of de sleutel controles op resterend quotum omzeilt. Stel dit alleen in op `true` wanneer de sleutel moet blijven werken, zelfs als `remain_quota` `0` is.
`model_limits_enabled`	boolean	Of deze sleutel moet worden beperkt tot specifieke modellen. Wanneer `false`, wordt `model_limits` genegeerd.
`model_limits`	string	Door komma’s gescheiden model IDs die door deze sleutel zijn toegestaan wanneer `model_limits_enabled` `true` is. Gebruik model IDs die worden geretourneerd door `/v1/models`; gebruik een lege string als er geen modelbeperking is.
`allow_ips`	string or null	Optionele IP-toestaanlijst. Geef één JSON-string op met items gescheiden door regeleindetekens (`\n`). Elk item kan een enkel IPv4-adres, enkel IPv6-adres, IPv4 CIDR of IPv6 CIDR zijn. Gebruik `null` of `""` om IP-beperkingen uit te schakelen.
`group`	string	Optionele accountgroepbeperking. Gebruik een lege string als er geen expliciete groep is. Niet-lege waarden moeten beschikbaar zijn voor het account, anders retourneert de API `success: false`.
`cross_group_retry`	boolean	Of cross-group retry is ingeschakeld voor automatische groeproutering. Dit is alleen zinvol wanneer de sleutel een automatisch gerouteerde groep gebruikt.

Allowlist-indeling

Om meerdere IP’s of CIDR-bereiken toe te staan, stuur je ze als één JSON-string met \n tussen de items:

{
  "allow_ips": "198.51.100.10\n203.0.113.0/24\n2001:db8::/32"
}

Dit voorbeeld staat één IPv4-adres, één IPv4 CIDR-bereik en één IPv6 CIDR-bereik toe.

Autorisaties

Authorization

string

header

vereist

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

Body

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

Voorbeeld:

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

Voorbeeld:

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

Voorbeeld:

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.

Voorbeeld:

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.

Voorbeeld:

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.

Voorbeeld:

""

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.

Voorbeeld:

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

Voorbeeld:

""

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.

Voorbeeld:

false

Respons

200 - application/json

Create result.

success

boolean

vereist

Whether the create operation succeeded.

Voorbeeld:

true

message

string

vereist

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

Voorbeeld:

""

API-sleutels weergeven

Een API-sleutel ophalen

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

​Request body

​Allowlist-indeling

Autorisaties

Body

Respons

Request body

Allowlist-indeling