Langsung ke konten utama
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.

Gunakan endpoint ini untuk membuat API key untuk otomatisasi, dashboard internal, atau integrasi sisi server.
Buat personal access token di Console → Personal Settings, lalu kirimkan sebagai nilai mentah header Authorization. Jangan tambahkan awalan Bearer.
Respons pembuatan hanya mengonfirmasi keberhasilan. Respons ini tidak menyertakan record key baru atau nilai key. Setelah pembuatan, panggil List API keys untuk membaca record key terbaru.

​
Request body

FieldTypeDescription
namestringNama tampilan yang dapat dibaca pengguna untuk key. Harus 50 karakter atau kurang.
expired_timeintegerUnix timestamp dalam detik saat key kedaluwarsa. Gunakan -1 untuk tanpa kedaluwarsa.
remain_quotaintegerKuota awal dalam unit kuota internal CometAPI. Jika nilai ini mencapai 0 dan unlimited_quota adalah false, permintaan model dengan key ini akan ditolak karena kuota habis.
unlimited_quotabooleanApakah key melewati pemeriksaan sisa kuota. Setel true hanya ketika key harus tetap berfungsi meskipun remain_quota adalah 0.
model_limits_enabledbooleanApakah key ini dibatasi ke model tertentu. Saat false, model_limits diabaikan.
model_limitsstringmodel ID yang diizinkan oleh key ini, dipisahkan dengan koma, saat model_limits_enabled adalah true. Gunakan model ID yang dikembalikan oleh /v1/models; gunakan string kosong untuk tanpa pembatasan model.
allow_ipsstring or nullDaftar IP yang diizinkan opsional. Berikan satu string JSON dengan entri yang dipisahkan oleh karakter baris baru (\n). Setiap entri dapat berupa satu alamat IPv4, satu alamat IPv6, IPv4 CIDR, atau IPv6 CIDR. Gunakan null atau "" untuk menonaktifkan pembatasan IP.
groupstringPembatasan grup akun opsional. Gunakan string kosong untuk tanpa grup eksplisit. Nilai yang tidak kosong harus tersedia untuk akun, atau API mengembalikan success: false.
cross_group_retrybooleanApakah retry lintas grup diaktifkan untuk perutean grup otomatis. Ini hanya bermakna ketika key menggunakan grup yang dirutekan otomatis.

​
Format allowlist

Untuk mengizinkan beberapa IP atau rentang CIDR, kirimkan sebagai satu string JSON dengan \n di antara entri: 
{
  "allow_ips": "198.51.100.10\n203.0.113.0/24\n2001:db8::/32"
}
Contoh ini mengizinkan satu alamat IPv4, satu rentang IPv4 CIDR, dan satu rentang IPv6 CIDR.

Otorisasi

​
Authorization
string
header
wajib

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

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

Contoh:

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

Contoh:

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.

Contoh:

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.

Contoh:

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.

Contoh:

""

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

Contoh:

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

Contoh:

""

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

Contoh:

false

Respons

200 - application/json

Create result.

​
success
boolean
wajib

Whether the create operation succeeded.

Contoh:

true

​
message
string
wajib

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

Contoh:

""