Menu docs

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.

FieldArti
idNama model yang dikirim di model. Nama tidak berubah
context_windowUkuran konteks dalam token
pricing.input, cache_read, cache_write, outputEmpat tarif dalam USD per 1 juta token, lihat Harga
pricing.cache_write_1hTarif cache write yang bertahan 1 jam; null bila model tidak punya tarif itu
pricing.official_input, official_outputHarga resmi referensi, dipakai untuk menampilkan diskon sebenarnya
pricing.minimum_per_requestTagihan minimum per request sukses
pack_min_tierPaket budget terkecil yang mencakup model: 1 ($1,99), 2 ($9,99), 3 ($99); null untuk model gambar
pricing.variantsHanya 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
statusoperational, 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:

IDHargaPool
hy4-flash:free0 untuk semua tarifPool 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.