Zum Hauptinhalt springen
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.

Verwenden Sie diesen Endpunkt, um einen API-Schlüssel für Automatisierung, interne Dashboards oder serverseitige Integrationen zu erstellen.
Erzeugen Sie unter Console → Personal Settings ein Personal Access Token und senden Sie es dann als rohen Authorization-Header-Wert. Stellen Sie ihm nicht Bearer voran.
Die Antwort auf die Erstellung bestätigt nur den Erfolg. Sie enthält weder den neuen Schlüsseleintrag noch den Schlüsselwert. Rufen Sie nach der Erstellung List API keys auf, um den neuesten Schlüsseleintrag zu lesen.

​
Request body

FieldTypeDescription
namestringFür Benutzer lesbarer Anzeigename des Schlüssels. Muss 50 Zeichen oder weniger haben.
expired_timeintegerUnix-Zeitstempel in Sekunden, wann der Schlüssel abläuft. Verwenden Sie -1 für kein Ablaufdatum.
remain_quotaintegerStartkontingent in internen Kontingenteinheiten von CometAPI. Wenn dieser Wert 0 erreicht und unlimited_quota false ist, werden model-Anfragen mit diesem Schlüssel mit der Begründung „Kontingent erschöpft“ abgelehnt.
unlimited_quotabooleanGibt an, ob der Schlüssel Prüfungen des verbleibenden Kontingents umgeht. Setzen Sie true nur, wenn der Schlüssel weiter funktionieren soll, auch wenn remain_quota 0 ist.
model_limits_enabledbooleanGibt an, ob dieser Schlüssel auf bestimmte Modelle beschränkt werden soll. Wenn false, wird model_limits ignoriert.
model_limitsstringDurch Kommas getrennte model IDs, die für diesen Schlüssel erlaubt sind, wenn model_limits_enabled true ist. Verwenden Sie die von /v1/models zurückgegebenen model IDs; verwenden Sie einen leeren String, um keine Modelleinschränkung festzulegen.
allow_ipsstring or nullOptionale IP-Allowlist. Geben Sie einen JSON-String mit durch Zeilenumbruchzeichen (\n) getrennten Einträgen an. Jeder Eintrag kann eine einzelne IPv4-Adresse, eine einzelne IPv6-Adresse, ein IPv4-CIDR oder ein IPv6-CIDR sein. Verwenden Sie null oder "", um IP-Beschränkungen zu deaktivieren.
groupstringOptionale Einschränkung auf eine Kontogruppe. Verwenden Sie einen leeren String, wenn keine explizite Gruppe gesetzt werden soll. Nicht leere Werte müssen für das Konto verfügbar sein, andernfalls gibt die API success: false zurück.
cross_group_retrybooleanGibt an, ob kontoübergreifende Wiederholungsversuche für automatisches Gruppen-Routing aktiviert sind. Dies ist nur relevant, wenn der Schlüssel eine automatisch geroutete Gruppe verwendet.

​
Allowlist-Format

Um mehrere IPs oder CIDR-Bereiche zu erlauben, senden Sie sie als einen JSON-String mit \n zwischen den Einträgen: 
{
  "allow_ips": "198.51.100.10\n203.0.113.0/24\n2001:db8::/32"
}
Dieses Beispiel erlaubt eine IPv4-Adresse, einen IPv4-CIDR-Bereich und einen IPv6-CIDR-Bereich.

Autorisierungen

​
Authorization
string
header
erforderlich

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

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

Beispiel:

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

Beispiel:

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.

Beispiel:

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.

Beispiel:

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.

Beispiel:

""

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

Beispiel:

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

Beispiel:

""

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

Beispiel:

false

Antwort

200 - application/json

Create result.

​
success
boolean
erforderlich

Whether the create operation succeeded.

Beispiel:

true

​
message
string
erforderlich

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

Beispiel:

""