Harga penggunaan alat dan token
Permintaan penggunaan alat dihargai sama dengan permintaan API Claude lainnya, berdasarkan jumlah total token input yang dikirim ke model (termasuk dalam parameter tools
) dan jumlah token output yang dihasilkan.
Token tambahan dari penggunaan alat berasal dari:
- Parameter
tools
dalam permintaan API (nama alat, deskripsi, dan skema) - Blok konten
tool_use
dalam permintaan dan respons API - Blok konten
tool_result
dalam permintaan API
Saat Anda menggunakan tools
, kami juga secara otomatis menyertakan prompt sistem khusus untuk model yang memungkinkan penggunaan alat. Jumlah token penggunaan alat yang diperlukan untuk setiap model tercantum di bawah ini (tidak termasuk token tambahan yang tercantum di atas):
Model | Pilihan alat | Jumlah token prompt sistem penggunaan alat |
---|---|---|
Claude 3 Opus | auto | 530 token |
Claude 3 Opus | any , tool | 281 token |
Claude 3 Sonnet | auto | 159 token |
Claude 3 Sonnet | any , tool | 235 token |
Claude 3 Haiku | auto | 264 token |
Claude 3 Haiku | any , tool | 340 token |
Claude 3 Opus (legacy beta: tools-2024-04-04 ) | auto | 395 token |
Jumlah token ini ditambahkan ke token input dan output normal Anda untuk menghitung total biaya permintaan. Lihat tabel ikhtisar model kami untuk harga per model saat ini.
Saat Anda mengirim prompt penggunaan alat, seperti permintaan API lainnya, respons akan mengeluarkan jumlah token input dan output sebagai bagian dari metrik usage
yang dilaporkan.
Perlu diingat bahwa penggunaan alat sering kali memerlukan beberapa kali bolak-balik antara kode Anda dan Claude (untuk menjalankan alat dan mengembalikan hasil), sehingga satu kueri pengguna akhir dapat menghasilkan beberapa permintaan API dan biaya token terkait. Rancang alat dan prompt Anda agar seringkas mungkin sambil tetap memberikan informasi yang cukup agar Claude dapat menggunakan alat secara efektif.