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):

ModelPilihan alatJumlah token prompt sistem penggunaan alat
Claude 3 Opusauto530 token
Claude 3 Opusany, tool281 token
Claude 3 Sonnetauto159 token
Claude 3 Sonnetany, tool235 token
Claude 3 Haikuauto264 token
Claude 3 Haikuany, tool340 token
Claude 3 Opus (legacy beta: tools-2024-04-04)auto395 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.