Panduan
Model dan harga
Pahami ID model, penyedia, tarif yang dipublikasikan, diskon, unit penagihan, dan cara sebuah permintaan dihitung harganya.
Harga model dipublikasikan dalam USD. Sebuah model dapat tersedia melalui lebih dari satu penyedia upstream, dan setiap penyedia dapat mempublikasikan harga pelanggan yang berbeda. Panduan ini menjelaskan asal harga tersebut dan cara menghitung biaya permintaan sebelum Anda mengirimkannya.
Menemukan ID Model
Gunakan ID model yang dikembalikan oleh API. Jangan membangun ID dari nama tampilan atau slug halaman.
| Endpoint | Mengembalikan |
|---|---|
GET /api/v1/models | Setiap kategori model yang diaktifkan |
GET /api/v1/videos/models | Model generasi video |
GET /api/v1/decisions/models | Model keputusan |
GET /api/v1/models juga menerima exclude_video_and_decisions=true dan filter provider opsional. Penemuan membaca katalog dan tidak mengenakan biaya untuk panggilan model.
Model gambar tidak memiliki endpoint daftar khusus. Filter GET /api/v1/models berdasarkan model_kind: "image_generation"; lihat Generasi Gambar.
Untuk tampilan yang dapat dijelajahi, buka katalog model atau halaman harga. Halaman detail model menampilkan batas konteks, protokol, dan setiap harga penyedia yang dipublikasikan.
Penyedia dan Kanal
Setiap model membawa daftar kanal publik. Kanal adalah satu konfigurasi penyedia upstream untuk model tersebut, seperti Anthropic, Azure, Google, atau kanal Claude yang didiskon.
is_defaultmenandai kanal yang digunakan untuk harga utama dan rute default.runnablemenandai apakah kanal saat ini tersedia untuk permintaan.standard_pricingberisi tarif standar penyedia.discount_multiplieradalah pengali penjualan dari 0 hingga 1.pricing_modebernilaiconfigured_ratesatauupstream_cost.
Halaman model mengurutkan penyedia dengan yang default lebih dulu, lalu berdasarkan harga input pelanggan dari rendah ke tinggi. Untuk memilih penyedia secara eksplisit, lihat Kanal dan Routing Penyedia.
Cara Menghitung Harga Pelanggan
Untuk kanal configured_rates:
customer price = standard rate × discount multiplierMisalnya, kanal dengan tarif input standar $1.00 per 1 juta token dan pengali 0.8 mengenakan biaya $0.80 per 1 juta token.
Untuk kanal upstream_cost, standard_pricing bernilai null, bukan nol. Penagihan didasarkan pada biaya generasi yang dilaporkan dikalikan diskon yang dibekukan. Halaman model menampilkan aturan sebenarnya untuk kanal tersebut.
Tarif token ditampilkan per 1 juta token agar mudah dibaca. Penagihan menggunakan presisi per token dalam snapshot harga saat ini.
Unit Penagihan
| Unit | Penggunaan tipikal | Cara mengukurnya |
|---|---|---|
| Token | Chat, reasoning, embedding, generasi teks | Token input dan output secara terpisah; baca dan tulis cache dapat memiliki tarifnya sendiri |
| Token gambar | Generasi dan pengeditan gambar | Token gambar input dan output secara terpisah; jumlah token output per gambar bergantung pada resolusi |
| Permintaan | Beberapa endpoint gambar dan utilitas | Biaya tetap per panggilan |
| Detik atau tingkatan | Generasi video | Durasi, resolusi, input referensi, atau kondisi lain yang dipublikasikan |
Jika beberapa kondisi harga cocok, kondisi pertama yang cocok yang tercantum dalam detail harga model yang berlaku. Periksa halaman detail model untuk tingkatan sebelum memperkirakan pekerjaan besar.
Tarif Cache
Saat model mempublikasikan input_cache_read atau input_cache_write, tarif tersebut muncul di katalog dan di halaman model. Penggunaan cache dilaporkan oleh respons protokol; cache hit tidak dijamin dan bergantung pada penyedia upstream serta permintaan. Felo tidak menambahkan sakelar cache terpisah.
Di Mana Memeriksa Harga
- Halaman harga — bandingkan model dan penyedia.
- Halaman detail model — tabel tarif lengkap, tingkatan, dan kondisi.
- API katalog model — data yang sama dalam JSON, diperbarui dalam 60 detik.
Jangan menuliskan harga secara hardcode di aplikasi Anda. Baca katalog atau tampilkan tautan ke halaman harga agar perubahan harga tidak diam-diam merusak perkiraan biaya Anda.
Memperkirakan Permintaan
- Temukan ID model dan kanal yang akan Anda gunakan.
- Baca tarif input, output, dan cache kanal tersebut.
- Kalikan dengan perkiraan jumlah token Anda, atau gunakan tarif per permintaan atau durasi untuk model non-token.
- Tambahkan tingkatan bersyarat yang berlaku.
- Sisakan ruang untuk percobaan ulang dan varian output.