Perutean transparan dan rincian flight

GetVibe adalah router transparan: Anda memilih varian publik secara eksplisit melalui akhiran :alias, atau membiarkan nama model tanpa akhiran — maka gateway memilih rute sesuai strategi akun/kunci Anda dan, jika terjadi kegagalan, beralih ke varian lain yang tersedia. Hanya pengenal rute publik yang digunakan dalam respons dan riwayat.

"model": "claude-opus-4.8"          // auto — key strategy
"model": "claude-opus-4.8:yellow"   // pin — :yellow only, no switching to other channels
"model": "claude-opus-4.8:2"        // pin — catalog variant #2 (legacy :N syntax)

Setiap model dilayani oleh beberapa kanal dengan harga berbeda — sebuah tangga. Dua parameter body permintaan ini menentukan tingkat tangga mana yang boleh melayani Anda. Keduanya USD per 1M token, satuan dan angka yang sama seperti yang ditampilkan halaman Models. Keduanya dibandingkan dengan harga kami — yang Anda bayar — bukan dengan angka grosir yang tidak dapat Anda lihat.

{
  "model": "deepseek-v4-flash-0731",
  "messages": [{"role": "user", "content": "hi"}],
  "max_price": 0.02,
  "min_price": {"input": 0.001}
}

Kedua sisi harus terpenuhi, input dan output — jangan pernah mengambil rata-rata keduanya. Kanal yang murah pada input dan mahal pada output tidak memenuhi batas satu angka.

Batas tetap, ditetapkan sekali di kabinet

Batas atas tidak harus disertakan pada setiap panggilan. Dashboard menyimpan satu batas per API key dan per model, plus satu default yang mencakup setiap model yang belum Anda tetapkan secara eksplisit, dan API membacanya pada setiap permintaan. Permintaan yang membawa max_price memakai nilai itu sebagai gantinya untuk satu panggilan tersebut; permintaan yang tidak membawa apa pun memakai batas atas tersimpan Anda. Prioritas, dari yang paling spesifik:

Di mana membaca harga yang Anda batasi

GET /api/catalog mempublikasikan array channels untuk setiap model: satu entri per channel yang bisa menjadi tujuan permintaan, dari yang termurah lebih dulu, masing-masing dengan alamat yang bisa Anda gunakan untuk menyematkannya, harga inputUsd / outputUsd per 1M token dan apakah itu default. Itulah angka persis yang dibandingkan dengan max_price dan min_price, dan angka persis yang menjadi dasar penagihan Anda — satu daftar, bukan tiga.

curl -s https://getvibeapi.com/api/catalog   | jq '.[] | select(.apiModel=="z-ai/glm-5.3") | .channels'

Apa yang Anda ditagih

Anda ditagih untuk channel yang benar-benar melayani permintaan, ditambah markup tetap kami — bukan untuk batas atas yang Anda tetapkan, dan tidak pernah lebih dari itu. Jika Anda membatasi pada suatu harga dan permintaan terisi pada tingkat yang lebih murah, Anda membayar yang lebih murah. Tangga harga di halaman model menunjukkan rentang, dan angka “from” adalah tingkat termurah yang ada — itu harga nyata yang bisa Anda bayar, bukan janji bahwa permintaan ini akan mendarat di sana. Tetapkan max_price saat Anda butuh batas atas yang terjamin.

Saat tidak ada yang cocok

Permintaan ditolak: HTTP 422 dengan "type": "price_bound_no_lane", yang mencantumkan harga channel termurah dan termahal untuk model tersebut serta daftar channels lengkapnya, sehingga Anda dapat memilih batas dari angka-angka itu alih-alih menebaknya. lowest_passing_usd_per_million adalah batas terkecil yang saat ini menerima sebuah channel — pasangan milik satu channel itu sendiri, jadi mengirimkannya akan lolos (kedua leg cheapest boleh berasal dari channel yang berbeda). Field yang sama muncul ketika bursa itu sendiri menolak batas Anda: maka nilainya adalah tingkat harga berikutnya yang masih memiliki pasokan, dan tidak pernah lebih rendah daripada batas yang Anda kirimkan. Ketika batas Anda bukan penyebabnya — melainkan plafon pembelian kami sendiri untuk channel tersebut, sementara penawaran di bawahnya sedang sibuk atau habis — jawabannya adalah HTTP 503 "type": "no_seller_available" dengan Retry-After dan tanpa harga saran: menaikkan max_price tidak akan membantu, mencoba lagi sebentar lagi mungkin bisa. Tingkat termurah sering kali hanya menampung satu penawaran yang sibuk, jadi untuk pengisian yang andal tetapkan batas pada atau di atas priceTypical model tersebut, tempat sebagian besar pasokan berada. Kami tidak pernah diam-diam melayani channel yang lebih mahal, dan kami tidak pernah menggantinya dengan model lain. Nilai yang salah bentuk — string, nol, negatif, field yang tidak dikenal — adalah 400 invalid_request_error, tidak pernah diabaikan begitu saja.

{
  "error": {
    "message": "No channel of model "deepseek-v4-flash-0731" is priced within your max_price $0.0001 in / $0.0001 out...",
    "type": "price_bound_no_lane",
    "code": 422,
    "param": "max_price",
    "cheapest_usd_per_million": {"input": 0.0065, "output": 0.013},
    "dearest_usd_per_million": {"input": 0.0528, "output": 0.1584},
    "lowest_passing_usd_per_million": {"input": 0.0205, "output": 0.0613},
    "channels": [
      {"address": "deepseek/deepseek-v4-flash-0731:codebuddy-cn", "label": "codebuddy-cn", "inputUsd": 0.0205, "outputUsd": 0.0613, "isDefault": true},
      {"address": "deepseek/deepseek-v4-flash-0731:qwencloud", "label": "qwencloud", "inputUsd": 0.0378, "outputUsd": 0.1132, "isDefault": false}
    ]
  }
}

Channel yang dilayani dari pool langganan vendor dapat dialamatkan dengan nama. Tuliskan nama setelah titik dua, persis seperti alias lainnya:

"model": "gpt-6.1-sol:codex"         // pin a subscription pool
"model": "claude-opus-5.5:claude-code"  // pin the Claude Code pool

Sufiks setelah titik dua adalah pengenal rute publik, bukan nama upstream. Daftar lengkap untuk model tertentu ada di katalog (Models, kolom «In API»). Alias utama:

Untuk permintaan auto (model tanpa varian), hal-hal berikut ditetapkan pada setiap kunci API (dasbor → API keys):

Tambahkan alias provider setelah titik dua — alias ini dipatuhi terlepas dari strategi routing. Daftar lengkap alias dan contohnya — di bagian Models → Providers.

"model": "claude-opus-4.8"        // auto — key strategy
"model": "claude-opus-4.8:yellow"     // explicitly pin the :yellow channel
"model": "claude-opus-4.8:kiro-pool"  // explicitly pin the :kiro-pool channel

Untuk setiap API key Anda dapat mengatur di dashboard:

Dengan bare model gateway dapat beralih ke varian publik lain dari model yang sama jika varian saat ini mengembalikan 429, 5xx, atau 200 kosong tanpa konten. Batasan:

• Permintaan dengan gambar/PDF tidak dialihkan ke penyedia lain (kompatibilitas vision).
• Failover tidak beralih ke varian yang jauh lebih mahal (kecuali strategy=price).
• Ada batas atas jumlah percobaan per permintaan klien.
• Dengan pin (:alias) failover antar-provider mati — Anda mendapat error dari rute yang dipilih.

Mencoba ulang dengan exponential backoff pada 429 dijelaskan di Errors and limits.

Untuk klien reveal/debug yang tepercaya, setelah permintaan selesai (termasuk auto) header tersedia yang menunjukkan varian public mana yang benar-benar dijalankan. Klien biasa tidak diberikan data ini.

Header respons untuk klien trusted reveal/debug (chat / messages / responses)

curl -sD - https://getvibeapi.com/v1/chat/completions \
  -H "Authorization: Bearer $GETVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6.1-sol","messages":[{"role":"user","content":"ping"}],"max_tokens":8}' \
  -o /dev/null | grep -i getvibe

# x-getvibe-route: yellow
# x-getvibe-model: gpt-6.1-sol:yellow

Riwayat penggunaan

Di GET /v1/generations, GET /v1/usage dan dashboard, setiap record memiliki field berikut:

GetVibe tidak menyediakan daftar waterfall «mentah» yang menampilkan penyedia upstream di dalam body permintaan. Kendali dilakukan melalui :alias publik, strategi kunci, dan auto-failover di dalam katalog model. Tidak ada API «ignore providers» terpisah atau flag routing ZDR.