Model

Kolom model menerima nama model secara persis. Daftar lengkap dengan harga dan dukungan cache ada di halaman katalog.

• ID menggunakan vendor/model (gaya OpenRouter), misalnya anthropic/claude-opus-5; claude-opus-5 diterima sebagai alias masukan dengan penagihan yang identik.
• model:alias menyematkan sebuah channel, misalnya openai/gpt-5.6-sol:yellow. GET /v1/models menampilkan satu ID per model; ?variants=1 mengembalikan daftar lengkapnya.

Sebagian besar kanal adalah marketplace book: banyak penjual menawarkan model yang sama dengan harga berbeda. Permintaan Anda terisi pada penawaran termurah yang menerimanya, dan Anda ditagih sebesar biaya pengisian tersebut ditambah komisi kami. Karena itu, tarif per token berupa rentang, bukan satu angka — bergantung pada tingkatan book mana yang mengisi permintaan.

GET /api/catalog dan GET /v1/pricing mempublikasikan rentang itu per model (pricing) dan per channel (channels[]), dibaca dari tangga yang sama yang dilayani GET /api/model-ladder?model=<model> beserta jumlah penawarannya.

"pricing": {
  "basis": "fill",
  "unit": "USD per 1M tokens",
  "priceFrom":    { "input": 0.465, "output": 2.325 },
  "priceTypical": { "input": 0.5,   "output": 2.5 },
  "priceTo":      { "input": 1.5,   "output": 7.5 },
  "minChargePerRequest": 0.0000125,
  "ladder": "/api/model-ladder?model=claude-opus-5.5",
  "ladderUpdatedAt": "2026-09-25T08:45:01.522Z",
  "ladderStale": false
},
"channels": [
  { "address": "claude-opus-5.5:claude-code", "isDefault": true,
    "inputUsd": 0.465, "outputUsd": 2.325,
    "basis": "fill", "pool": "cc/claude-opus-5-5",
    "priceFrom": { "input": 0.465, "output": 2.325 },
    "priceTypical": { "input": 0.5, "output": 2.5 },
    "priceTo": { "input": 1.5, "output": 7.5 },
    "maxPriceCeiling": { "input": 0.6, "output": 3 },
    "minChargePerRequest": 0.0000125 }
]

Sebagian besar model memiliki beberapa varian publik. Varian default dipilih secara otomatis (prioritas mengikuti pengaturan akun atau kunci Anda). Untuk menetapkan varian tertentu bagi suatu permintaan, tambahkan aliasnya setelah tanda titik dua pada nama model:

"model": "gpt-6.1-sol"           // default variant (auto)
"model": "gpt-6.1-sol:yellow"    // explicit public variant
"model": "claude-opus-5.5"     // use an id from the catalog

Contoh permintaan dengan varian eksplisit:

curl https://getvibeapi.com/v1/chat/completions \
  -H "Authorization: Bearer $GETVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4.8:yellow",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
# :yellow — pin a public variant for this request

Gunakan hanya alias dari katalog. Sufiks yang tersedia:

Anda dapat mengambil daftar lengkap id model yang tersedia secara terprogram:

curl https://getvibeapi.com/v1/models \
  -H "Authorization: Bearer $GETVIBE_API_KEY"

Selain id/object/created/owned_by, setiap entri membawa type (chat, embedding, rerank, image, video, audio, music, 3d), architecture.input_modalities / output_modalities dan endpoints — tempat mengirim permintaan untuk model tersebut.

• Daftar default hanya memuat model chat, embedding, dan rerank, sehingga pemilih model di IDE tidak pernah menawarkan model yang tidak dapat melakukan chat.
• Model media (gambar, video, audio, musik, 3D) didaftarkan berdasarkan permintaan: ?type=image (atau daftar: ?type=image,video), ?output_modalities=image; ?modality= dan ?category= adalah sinonim dari type.
• Semuanya sekaligus: ?all=true, ?type=all atau GET /v1/models/all. Media dicantumkan bersama variannya (model:alias) — persis id yang harus dikirim.
• GET /v1/models/{id} mengembalikan satu model; id yang tidak dikenal adalah 404 dengan code: "model_not_found".

curl "https://getvibeapi.com/v1/models?type=image,video" \
  -H "Authorization: Bearer $GETVIBE_API_KEY"

Setiap model yang ditambahkan ke katalog dan postingan pembaruan terbaru kami diterbitkan dalam feed terbuka — tanpa memerlukan kunci. Baca feed melalui pembaca RSS atau agen, sehingga agen dapat menyesuaikan pendekatannya seiring perubahan model. Feed ini memuat seluruh riwayat, halaman demi halaman, dan setiap peristiwa memuat informasi yang dibutuhkan agen untuk langsung memanggil model.

• /rss.xml (alias /feed.xml) menggunakan RSS 2.0; /feed.json menggunakan JSON Feed 1.1 dengan blok _meta pada tingkat feed dan blok _catalog untuk setiap peristiwa.
• Halaman: masing-masing 50 peristiwa, ?limit= hingga 100, dengan yang terbaru di urutan pertama. Halaman berikutnya (lebih lama) adalah next_url dalam JSON Feed dan <atom:link rel="next"> dalam RSS (RFC 5005, juga dengan rel="first" dan rel="previous"). Tautan menyertakan kursor, sehingga model yang diterbitkan saat Anda menelusuri halaman tidak akan menggeser peristiwa yang sudah Anda baca. Gunakan tautan sebagaimana dikembalikan.
• Filter: ?kind=text|image|video|audio|music|3d|news dan ?since=YYYY-MM-DD — hanya peristiwa sejak hari UTC tersebut, termasuk hari itu sendiri. Filter dapat digunakan bersama paginasi dan tetap disertakan dalam tautan.
• Peristiwa model_added memuat judul, tanggal model muncul di katalog, tautan ke halaman model, deskripsi, dan, di dalam _catalog: ID publik yang dikirim sebagai model (tanpa penulisan rute :alias dan tanpa nama pemasok), endpoint, modalitas input dan output, jendela konteks dan output maksimum, kapabilitas (alat, JSON / output terstruktur, visi, penalaran beserta tingkatannya, caching), harga awal publik dalam USD beserta satuannya, untuk media setiap parameter permintaan beserta nilai yang diizinkan, permintaan siap pakai (curl dan JSON), serta tautan dokumentasi. Peristiwa news adalah postingan tentang pembaruan terbaru.
• guid suatu event tidak pernah berubah. Feed ini tidak memiliki hasil generasi yang tercatat, hanya request contoh.
• Lakukan polling paling sering setiap beberapa menit: setiap halaman memiliki ETag dan Last-Modified sendiri; kirim If-None-Match / If-Modified-Since dan halaman yang tidak berubah akan merespons 304 tanpa isi respons. Untuk mengambil hanya yang baru, simpan tanggal peristiwa terakhir yang Anda proses dan gunakan tanggal tersebut dalam permintaan ?since=.

curl -sS "https://getvibeapi.com/feed.json?since=2026-10-01&limit=100"
curl -sS -i https://getvibeapi.com/feed.json -H 'If-None-Match: "<ETag from the previous response>"'   # -> 304