Felo API PlatformFelo API Platform

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.

EndpointMengembalikan
GET /api/v1/modelsSetiap kategori model yang diaktifkan
GET /api/v1/videos/modelsModel generasi video
GET /api/v1/decisions/modelsModel 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_default menandai kanal yang digunakan untuk harga utama dan rute default.
  • runnable menandai apakah kanal saat ini tersedia untuk permintaan.
  • standard_pricing berisi tarif standar penyedia.
  • discount_multiplier adalah pengali penjualan dari 0 hingga 1.
  • pricing_mode bernilai configured_rates atau upstream_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 multiplier

Misalnya, 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

UnitPenggunaan tipikalCara mengukurnya
TokenChat, reasoning, embedding, generasi teksToken input dan output secara terpisah; baca dan tulis cache dapat memiliki tarifnya sendiri
Token gambarGenerasi dan pengeditan gambarToken gambar input dan output secara terpisah; jumlah token output per gambar bergantung pada resolusi
PermintaanBeberapa endpoint gambar dan utilitasBiaya tetap per panggilan
Detik atau tingkatanGenerasi videoDurasi, 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

  1. Temukan ID model dan kanal yang akan Anda gunakan.
  2. Baca tarif input, output, dan cache kanal tersebut.
  3. Kalikan dengan perkiraan jumlah token Anda, atau gunakan tarif per permintaan atau durasi untuk model non-token.
  4. Tambahkan tingkatan bersyarat yang berlaku.
  5. Sisakan ruang untuk percobaan ulang dan varian output.

Terkait