Lewati ke konten
Selesai Docs

Rekonsiliasi biaya

Ekstensi cost-reconcile mencatat biaya tagihan nyata yang dilaporkan provider dalam payload responsnya sendiri, sehingga total biaya sesi sesuai dengan tagihan aktual, bukan estimasi rate card.

Dibundel bersama Selesai

Dimuat otomatis bersama Selesai; tidak diperlukan npm install per ekstensi.

Entri manifest
./cost-reconcile.ts
Permukaan runtime
Otomatis

Penyiapan dan prasyarat

  • Dibundel bersama Selesai dan dimuat otomatis; tidak perlu diinstal terpisah.
  • Bekerja dengan gateway yang melaporkan biaya dalam respons: LiteLLM (header x-litellm-response-cost), OpenRouter (usage.cost / total_cost), dan cost.total berbentuk objek.
  • Provider yang payload-nya tidak memuat biaya (OpenAI/Anthropic first-party) tetap mempertahankan estimasi rate card, yang cocok dengan tagihan saat harga katalog dikonfigurasi.

Yang disiapkan

  • Memasang fetch pembungkus stream sekali per proses yang memindai respons API LLM untuk biaya yang dilaporkan provider dan id respons. Respons streaming mengulang id respons lintas chunk dan membawa id tool-call (call_*), sehingga pembungkus meng-key biaya tagihan untuk setiap id yang ditemukan. Capture selesai sebelum SDK provider men-finalisasi pesan asisten.
  • Pada message_end, menggantikan usage.cost.total pesan asisten final dengan jumlah tagihan yang dilaporkan provider sebelum pesan dipersistenkan, mengonsumsi hanya entri yang cocok dengan responseId pesan final, dan menulis entri sesi kustom cost-reconcile per id respons (dibatasi per sesi) untuk kompatibilitas zentui dan sesi yang ada. Capture duplikat untuk id yang sama (retry) ditandai ambigu daripada menetapkan salah satu tagihan.
  • Footer zentui mengutamakan entri hasil rekonsiliasi daripada total rate card saat keduanya ada untuk id respons yang sama, dan menyegarkan sekali setelah settle agar rekonsiliasi yang terlambat ikut terbaca.
  • Label biaya diformat secara adaptif agar biaya per panggilan di bawah satu sen tetap terlihat: 3 desimal di $1+, 4 desimal di $0.01+, dan 6 desimal di bawahnya (mis. $0.000336, bukan $0.000).

Yang dapat dikonfigurasi

Rekonsiliasi biaya bersifat otomatis: ia menangkap biaya yang dilaporkan provider dari respons LLM dan mencatatnya sebagai entri sesi; footer zentui mengutamakannya daripada estimasi rate card.

Tidak ada konfigurasi user

Kemampuan ini tidak mengekspos pengaturan yang dapat diedit user. Perilakunya dikontrol oleh command dan aturan runtime yang didokumentasikan di bawah.

Bukti source

Tidak ada pengaturan user. Batas penangkapan adalah konstanta di sumber ekstensi.

Yang dapat dilakukan

  • Melihat total biaya sesi yang sesuai dengan tagihan gateway sebenarnya.
  • Menjaga label biaya footer zentui akurat untuk gateway bergaya OpenRouter dan katalog kustom dengan harga bertanggal.

Perintah, tool, dan shortcut

  • Tidak ada. Ekstensi sepenuhnya otomatis.

Batasan dan keamanan

  • Penangkapan bersifat best-effort: body respons dipindai di latar belakang sementara aliran respons melewati tanpa berubah; respons utama tidak pernah diubah.
  • Body dipindai hingga batas ukuran; kecocokan biaya terakhir dalam stream yang menang (usage tiba di chunk akhir).
  • Ekstensi tidak pernah membaca atau menyimpan isi pesan — hanya id respons, nama provider/model, dan angka biaya yang dilaporkan.

Source evidence

Selesai version: 0.10.0