Docs / API
Models
GET /v1/models menampilkan model aktif beserta empat tarif, jendela konteks, dan statusnya.
Terakhir diperbarui
Endpoint
GET https://api.cent-ai.dev/v1/models
Authorization: Bearer cai_<secret>
Endpoint ini butuh API key. Katalog yang sama tersedia publik di halaman harga situs.
curl https://api.cent-ai.dev/v1/models \
-H "Authorization: Bearer $CENT_AI_KEY"
Respons
{
"object": "list",
"data": [{
"id": "glm-5.3",
"object": "model",
"created": 1790000000,
"owned_by": "cent-ai",
"context_window": 1000000,
"pricing": {
"currency": "USD",
"per": "1M tokens",
"input": "0.070000000",
"cache_read": "0.013000000",
"cache_write": "0.070000000",
"cache_write_1h": null,
"output": "0.220000000",
"official_input": "1.400000000",
"official_output": "4.400000000",
"minimum_per_request": "0.000020000"
},
"pack_min_tier": 2,
"capabilities": ["tools", "reasoning"],
"status": "operational"
}]
}
Nilai di atas adalah contoh bentuk, bukan harga yang berlaku.
| Field | Arti |
|---|---|
id | Nama model yang dikirim di model. Nama tidak berubah |
context_window | Ukuran konteks dalam token |
pricing.input, cache_read, cache_write, output | Empat tarif dalam USD per 1 juta token, lihat Harga |
pricing.cache_write_1h | Tarif cache write yang bertahan 1 jam; null bila model tidak punya tarif itu |
pricing.official_input, official_output | Harga resmi referensi, dipakai untuk menampilkan diskon sebenarnya |
pricing.minimum_per_request | Tagihan minimum per request sukses |
pack_min_tier | Paket budget terkecil yang mencakup model: 1 ($1,99), 2 ($9,99), 3 ($99); null untuk model gambar |
pricing.variants | Hanya model gambar: daftar {name, unit, price, official_price}, harga per gambar (unit image) dalam USD. Model gambar ditagih dengan harga ini, bukan dengan field per token; lihat Gambar |
status | operational, degraded, down, atau coming_soon |
Nominal berupa string desimal dengan 9 digit pecahan, sehingga presisinya tidak hilang di tipe float.
Model event
Selama event, beberapa model tampil dengan ID :free dan harga 0. Model ini tidak punya ID berbayar, jadi nama itulah satu-satunya yang bisa dikirim:
| ID | Harga | Pool |
|---|---|---|
hy4-flash:free | 0 untuk semua tarif | Pool tetap per hari UTC; angka terkini ada di halaman event |
Model ini gratis untuk waktu terbatas dan dapat berakhir sewaktu-waktu. Saat pool hari itu habis, request dijawab 429 rate_limited dengan header Retry-After sampai 00:00 UTC. Sisa pool langsung ada di halaman event.
Nama model
Pakai id persis seperti di daftar. Nama yang tidak ada, atau model yang tidak tersedia, dijawab 404 model_not_found dengan pesan "The model '{model}' does not exist or is not available."
Kontrak
GET/v1/models
List models with their rates
Autentikasi · Key API (Bearer atau x-api-key)
Respons
- 200Active models.
- 401Error in the OpenAI shape.
Header respons
x-request-id
Dibuat dari kontrak OpenAPI.