Migrasi ke Claude Sonnet 5.5
Pindahkan kode ke Claude Sonnet 5.5 dari Claude Sonnet 5, Claude Sonnet 4.6, Claude Sonnet 4.5, Claude Sonnet 4, Claude 3.7 Sonnet, atau Claude Haiku 4.5: pengaturan yang mengembalikan error, perubahan pemikiran, dan daftar periksa untuk setiap model awal.
Panduan ini mencantumkan perubahan kode untuk berpindah ke Claude Sonnet 5.5 dari Claude Sonnet 5, Claude Sonnet 4.6, Claude Sonnet 4.5, Claude Sonnet 4, Claude 3.7 Sonnet, atau Claude Haiku 4.5. Baca dua bagian pertama, lalu lanjutkan membaca hingga bagian untuk model Anda saat ini. Daftar periksa migrasi mencantumkan setiap perubahan berdasarkan model awal.
Claude Sonnet 5.5 memiliki harga yang sama dengan Claude Sonnet 5. Lihat harga Claude. Untuk "context window" (jendela konteks) dan batas output-nya, lihat halaman model Claude Sonnet 5.5. Untuk fitur dan prompting, lihat Yang baru di Claude Sonnet 5.5 dan Prompting Claude Sonnet 5.5.
Mengirim permintaan ke Claude Sonnet 5.5
Permintaan ini berfungsi di Claude Sonnet 5.5 sebagaimana tertulis. Permintaan ini menetapkan "effort level" (tingkat upaya), dan tab SDK membaca balasan berdasarkan jenis blok. Permintaan ini tidak menyertakan lima pengaturan yang mengembalikan error 400: anggaran pemikiran, parameter sampling, "prefill" (pengisian awal) asisten, pilihan alat yang dipaksakan, dan thinking: {"type": "disabled"}.
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=4096,
messages=[
{
"role": "user",
"content": "Analyze the trade-offs between microservices and monolithic architectures",
}
],
output_config={"effort": "medium"},
)
print(f"Stop reason: {response.stop_reason}")
for block in response.content:
if block.type == "text":
print(block.text)Pemikiran berjalan secara default
Di Claude Sonnet 5.5, permintaan tanpa field thinking berjalan dengan "adaptive thinking" (pemikiran adaptif), sama seperti thinking: {"type": "adaptive"}. Di Claude Sonnet 4.6 dan model sebelumnya serta di Claude Haiku 4.5, permintaan tersebut berjalan tanpa pemikiran. Agar tetap berjalan tanpa pemikiran di awal, lihat Menonaktifkan pemikiran di awal.
| Model | Pemikiran tanpa field thinking | Nilai thinking.type yang diterima | display default |
|---|---|---|---|
| Claude Sonnet 5.5 | Aktif | "adaptive", "between_tools" | "omitted" |
| Claude Sonnet 5 | Aktif | "adaptive", "disabled" | "omitted" |
| Claude Sonnet 4.6 | Nonaktif | "adaptive", "disabled", "enabled" (usang) | "summarized" |
| Claude Sonnet 4.5 dan Claude Haiku 4.5 | Nonaktif | "disabled", "enabled" | "summarized" |
Menangani pemikiran dalam respons
Kode yang sebelumnya berjalan tanpa pemikiran memerlukan ketiga poin berikut. Kode dari Claude Sonnet 5 kemungkinan sudah memiliki dua poin pertama.
- Baca blok konten berdasarkan
type. Respons dapat diawali dengan blokthinking, sehingga kode yang membacacontent[0].textakan rusak. - Kirimkan kembali blok
thinkingtanpa perubahan dalam loop penggunaan alat, termasuk blok yang kosong. Lihat Mempertahankan blok thinking. - Tinjau kembali
max_tokens. Nilai ini mencakup pemikiran ditambah teks, dan token pemikiran ditagih sebagai token output. Lihat Kontrol biaya.
Teks pemikiran dihilangkan secara default. Blok thinking tiba dengan field thinking yang kosong dan sebuah signature. Untuk mendapatkan ringkasan yang dapat dibaca, tetapkan display: "summarized", yang merupakan default di Claude Sonnet 4.6 dan model sebelumnya serta di Claude Haiku 4.5. Lihat Mengontrol tampilan pemikiran.
Menonaktifkan pemikiran di awal
Untuk menonaktifkan pemikiran di awal pada Claude Sonnet 5.5, kirimkan thinking: {"type": "between_tools"}. Ini adalah pengaturan pemikiran terendah. Pembaruan progresnya di antara pemanggilan alat tetap dikembalikan sebagai blok thinking beserta teks ringkasannya. Tanpa alat, respons hanya berisi teks. Claude Sonnet 5 menonaktifkan pemikiran dengan thinking: {"type": "disabled"}, dan model sebelumnya berjalan tanpa pemikiran secara default. Di Claude Sonnet 5.5, disabled mengembalikan invalid_request_error 400:
"thinking.type.disabled" is not supported for this model. Use "thinking.type.between_tools" for the lowest thinking setting, or "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.between_tools berfungsi di setiap platform yang menawarkan Claude Sonnet 5.5, tanpa beta header. Nilai ini diterima pada effort low, medium, dan high. Pada xhigh atau max, nilai ini mengembalikan error 400. Untuk berjalan pada tingkat tersebut, gunakan pemikiran adaptif: hilangkan field thinking atau kirimkan thinking: {"type": "adaptive"}. between_tools tidak menerima field lain: display, budget_tokens, atau block_binding yang dikirim bersamanya mengembalikan error 400. Dengan fallback sisi server, permintaan between_tools yang beralih ke Claude Sonnet 5 akan berjalan di sana dengan thinking: {"type": "disabled"}.
Dengan between_tools, effort tidak dapat berubah di tengah percakapan: output_config.effort per pesan yang berbeda dari tingkat yang sedang berlaku mengembalikan error 400. Untuk memvariasikan effort per giliran, gunakan pemikiran adaptif. Untuk panduan prompting, lihat Berjalan tanpa pemikiran di awal.
Pada versi SDK yang tidak mendefinisikan between_tools, contoh Python dan TypeScript gagal dalam pemeriksaan tipe. Perbarui SDK, atau kirimkan nilai tersebut sebagai JSON mentah, seperti yang dilakukan contoh C#, Go, dan Java.
Sebelum (Claude Sonnet 5):
client.messages.create(
model="claude-sonnet-5",
max_tokens=16000,
thinking={"type": "disabled"},
output_config={"effort": "xhigh"},
messages=[{"role": "user", "content": "..."}],
)Sesudah (Claude Sonnet 5.5):
client.messages.create(
model="claude-sonnet-5-5",
max_tokens=16000,
thinking={"type": "between_tools"},
output_config={"effort": "high"},
messages=[{"role": "user", "content": "..."}],
)Daftar periksa migrasi berdasarkan model awal
Kerjakan grup-grup berikut secara berurutan dan berhenti setelah grup yang menyebutkan model Anda. Di Claude Haiku 4.5, terapkan setiap grup kecuali "Claude Sonnet 4 atau sebelumnya", dan akhiri dengan "Hanya Claude Haiku 4.5".
Setiap model awal
- Ubah ID model menjadi
claude-sonnet-5-5. - Baca blok konten berdasarkan
type, dan kirim kembali blokthinkingtanpa perubahan. - Agar tetap berjalan tanpa thinking di awal, kirim pengaturan thinking terendah pada effort
highatau lebih rendah. - Ganti penggunaan alat paksa dengan
autodan alat strict, atau denganautosaja di Amazon Bedrock. - Pertahankan percakapan agar hanya ditambahkan (append-only).
- Di Claude API dan Google Cloud, pindahkan computer use ke toolset, tanpa beta header
fine-grained-tool-streaming-2025-05-14. - Pasangkan alat advisor dengan advisor yang didukung, dan perkirakan saran yang terenkripsi.
- Baca teks di antara panggilan alat dari blok
thinking. - Tangani penolakan, dan konfigurasikan fallback.
- Jalankan ulang sweep effort Anda, dan tetapkan ulang baseline biaya.
Claude Sonnet 4.6 atau sebelumnya
- Perkirakan pemikiran pada permintaan tanpa field
thinking, dan tinjau kembalimax_tokens. - Ganti anggaran pemikiran dengan tingkat effort.
- Hapus nilai
temperature,top_p, dantop_kyang bukan default. - Jika Anda menampilkan teks pemikiran, tetapkan
display: "summarized". - Hitung ulang token, dan anggarkan ulang token gambar.
Claude Sonnet 4.5 atau sebelumnya
- Ganti prefill asisten.
- Parse input pemanggilan alat dengan parser JSON standar.
- Di Amazon Bedrock, pindahkan computer use dari
computer_20250124kecomputer_20251124. - Tetapkan
output_config.effortsecara eksplisit. - Hapus beta header jendela konteks apa pun.
- Hapus
interleaved-thinking-2025-05-14, dan gantifine-grained-tool-streaming-2025-05-14denganeager_input_streaming. - Pindahkan
output_formatkeoutput_config.format.
Claude Sonnet 4 atau sebelumnya
- Perbarui versi alat ke
text_editor_20250728dancode_execution_20260521. - Tangani stop reason
refusaldanmodel_context_window_exceeded. - Periksa parameter string alat untuk baris baru di akhir.
- Hapus
token-efficient-tools-2025-02-19danoutput-128k-2025-02-19. - Tinjau prompt Anda.
Hanya Claude Haiku 4.5
- Ganti
claude-haiku-4-5-20251001atau alias-nya. - Tetapkan ulang baseline biaya dengan harga per token yang lebih tinggi.
- Tinjau prompt yang terlalu pendek untuk di-cache di Claude Haiku 4.5.
Migrasi ke Claude Sonnet 5.5 dari Claude Sonnet 5
Setiap model awal memerlukan perubahan di bagian ini. Ganti ID model Anda dengan claude-sonnet-5-5, yang tidak memiliki akhiran tanggal. Di platform lain, gunakan ID yang tercantum di bawah Ketersediaan.
Penggunaan alat yang dipaksakan tidak didukung
Setiap model sebelumnya di halaman ini menerima tool_choice dengan tipe any atau tool. Claude Sonnet 5.5 menolak keduanya dengan error 400, termasuk di endpoint penghitungan token:
tool_choice: type "tool" and "any" are not supported for this model.Kirim tool_choice: {"type": "auto"}, dan tandai alat dengan strict: true agar inputnya sesuai dengan skema. Model kemudian dapat menjawab tanpa memanggil alat, jadi sebutkan dalam prompt kapan harus menggunakannya. Penggunaan alat strict mendukung subset JSON Schema dan memerlukan additionalProperties: false pada setiap objek. Lihat Batasan JSON Schema. Di Amazon Bedrock, "structured outputs" (output terstruktur), yang mencakup penggunaan alat strict, tidak tersedia untuk Claude Sonnet 5.5. Di sana, kirim auto tanpa strict, sebutkan dalam prompt kapan harus memanggil alat, dan validasi input alat di kode Anda.
Sebelum (Claude Sonnet 5):
client.messages.create(
model="claude-sonnet-5",
max_tokens=1024,
tools=tools,
tool_choice={"type": "tool", "name": "get_weather"},
messages=[{"role": "user", "content": "What's the weather in Paris?"}],
)Sesudah (Claude Sonnet 5.5):
client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
# strict tool use (penggunaan alat ketat): setiap panggilan sesuai dengan input_schema milik alat
tools=[{**tool, "strict": True} for tool in tools],
tool_choice={"type": "auto"},
messages=[
{
"role": "user",
"content": "What's the weather in Paris? Use the get_weather tool.",
}
],
)Contoh ini menandai setiap alat dalam daftar sebagai strict. Sebuah permintaan dapat memiliki paling banyak 20 alat strict, dan entri toolset MCP, computer use, dan browser use tidak menerima strict. Dalam daftar alat yang lebih panjang, tandai hanya alat yang memerlukannya.
Blok thinking terikat pada model dan percakapan
Claude Sonnet 5.5 membaca blok thinking dari Claude Sonnet 5, Claude Opus 4.8, Claude Haiku 4.5, dan model sebelumnya. Model ini tidak membaca blok dari Claude Opus 5, Claude Opus 5.5, atau model Claude Fable maupun Claude Mythos mana pun. API membuang blok yang tidak dapat dibaca oleh model. Permintaan tetap mengembalikan 200, dan blok yang dibuang tidak ditagih. Lihat Berganti model di tengah percakapan.
Setiap blok thinking Claude Sonnet 5.5 juga ditandatangani atas percakapan sebelumnya. Untuk akun yang dibuat pada atau setelah 31 Agustus 2026, pukul 00.00 UTC, API menerapkan hal ini secara default, di Claude API, Amazon Bedrock, dan Google Cloud. Pada akun tersebut, permintaan yang memutar ulang sebuah blok setelah riwayat sebelumnya diedit akan mengembalikan error 400. Pertahankan percakapan agar hanya ditambahkan, dan ubah instruksi atau alat dengan pesan sistem di tengah percakapan. Blok thinking yang dihasilkan Claude Sonnet 5.5 hanya berfungsi di akun yang menghasilkannya, atau di akun yang terhubung dengannya. Lihat Pemikiran yang dipertahankan.
Computer use memerlukan toolset di Claude API dan Google Cloud
Di Claude API dan Google Cloud, Claude Sonnet 5.5 mendukung computer use hanya melalui toolset computer_toolset_20260801. Di sana, computer_20251124 mengembalikan error 400. Claude Sonnet 5.5 tidak menerima computer_20250124 di platform mana pun. Temukan versi yang Anda kirimkan saat ini:
| Versi yang Anda kirimkan saat ini | Model awal yang mengirimkannya | Kirimkan di Claude API dan Google Cloud | Kirimkan di Amazon Bedrock |
|---|---|---|---|
computer_20251124 | Claude Sonnet 5, Claude Sonnet 4.6 | computer_toolset_20260801 | computer_20251124 |
computer_20250124 | Claude Sonnet 4.5, Claude Haiku 4.5, Claude Sonnet 4 | computer_toolset_20260801 | computer_20251124 |
Jika Anda mengirimkan beta header fine-grained-tool-streaming-2025-05-14, hapus header tersebut saat Anda berpindah ke toolset. Bersama entri toolset, header ini mengembalikan error 400. Sebagai gantinya, tetapkan eager_input_streaming: true pada setiap alat yang memerlukannya.
Kode yang sudah mengirimkan toolset tidak memerlukan perubahan. Migrasi dari computer_20251124 mencantumkan perubahan pada permintaan dan loop agen. Untuk platform lain, lihat Kompatibilitas.
Alat advisor menerima lebih sedikit advisor
Dengan alat advisor, executor Claude Sonnet 5.5 memerlukan salah satu advisor berikut: Claude Opus 5, Claude Opus 5.5, Claude Sonnet 5.5, Claude Fable 5, Claude Fable 5.1, Claude Mythos 5, atau Claude Mythos 5.1. Advisor Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5, dan Claude Sonnet 4.6 mengembalikan error 400. Saran dikembalikan dalam bentuk terenkripsi sebagai blok advisor_redacted_result, sehingga teksnya tidak dapat dibaca dalam respons. Lihat Kompatibilitas model.
Teks di antara pemanggilan alat dikembalikan dalam blok thinking
Di Claude Sonnet 5.5, catatan yang lebih panjang dari satu atau dua kalimat yang ditulis model di antara pemanggilan alat dikembalikan sebagai blok thinking pembaruan progres, yang kosong pada display default. Komentar yang lebih pendek tetap berupa text. Di Claude Sonnet 5 dan model sebelumnya, semua teks di antara pemanggilan alat dikembalikan sebagai blok text. Tidak ada permintaan yang gagal, tetapi antarmuka yang menampilkan catatan tersebut menjadi sepi.
Dengan pemikiran adaptif, tetapkan display ke "updates" (beta, header thinking-display-updates-2026-08-18) untuk mendapatkan pembaruan saja, atau ke "summarized" untuk mendapatkannya bercampur dengan penalaran. Render setiap blok thinking yang tidak kosong sebelum blok tool_use yang mengikutinya. Dengan between_tools, teks dikembalikan tanpa display. Lihat Pembaruan progres yang ditampilkan kepada pengguna.
Pengklasifikasi keamanan dan fallback
Claude Sonnet 5.5 menolak dalam lebih banyak kategori dibandingkan Claude Sonnet 5. Penolakan mengembalikan stop_reason: "refusal", dan stop_details-nya dapat menyebutkan salah satu kategori berikut:
"cyber": Permintaan dapat memungkinkan bahaya siber, seperti pengembangan malware atau exploit."bio": Permintaan dapat memungkinkan bahaya biologis, seperti metode laboratorium yang berbahaya."frontier_llm": Permintaan dapat membantu pengembangan model AI pesaing."reasoning_extraction": Permintaan meminta model untuk mereproduksi penalaran internalnya dalam teks respons."general_harms": Permintaan termasuk dalam area kebijakan penggunaan lainnya. Pekerjaan yang tidak berbahaya juga dapat memicu kategori ini.
Fallback sisi server (fallbacks: "default", beta, hanya Claude API) mencoba ulang penolakan "cyber" dan "frontier_llm" di Claude Sonnet 5. Fallback ini tidak mencoba ulang penolakan "bio", "reasoning_extraction", atau "general_harms". Lihat Penolakan dan fallback dan Cara penolakan ditagih.
Perlindungan siber real-time merupakan hal baru bagi kode dari Claude Sonnet 4.6, Claude Sonnet 4.5, dan Claude Haiku 4.5. Untuk pekerjaan keamanan yang sah, ajukan permohonan ke Cyber Verification Program.
Perubahan lainnya
- "Prompt caching" (caching prompt): Prompt minimum yang dapat di-cache adalah 512 token, turun dari 1.024 di Claude Sonnet 5, Claude Sonnet 4.6, dan Claude Sonnet 4.5. Lihat Caching prompt.
- Fitur baru: Untuk pesan sistem di tengah percakapan, perubahan alat di tengah percakapan, dan effort per pesan, lihat Yang baru di Claude Sonnet 5.5. Dengan
between_tools, effort tidak dapat berubah di tengah percakapan.
Perubahan yang direkomendasikan
Jalankan ulang pengujian effort Anda. Claude Sonnet 5.5 memiliki lima tingkat effort: low, medium, high, xhigh, dan max. Default di Claude API adalah high. Tingkat-tingkat ini telah dikalibrasi ulang, sehingga suatu tingkat tidak menghasilkan jumlah pemikiran yang sama seperti di Claude Sonnet 5. Mulailah dari high kecuali beban kerja Anda bersifat agentik atau sensitif terhadap "latency" (latensi). Untuk coding agentik dan penggunaan alat multilangkah, mulailah dari medium untuk tugas yang terdefinisi dengan baik dan naikkan ke high untuk tugas yang lebih sulit atau lebih panjang. Untuk chat dan pekerjaan lain yang sensitif terhadap latensi, mulailah dari medium atau low. Tetapkan tingkat tersebut di output_config.effort. Lihat Tingkat effort yang direkomendasikan untuk Claude Sonnet 5.5. Kemudian evaluasi ulang instruksi prompt khusus model berdasarkan Prompting Claude Sonnet 5.5.
Migrasi ke Claude Sonnet 5.5 dari Claude Sonnet 4.6 dan model Sonnet sebelumnya
Pertama, terapkan setiap bagian sebelumnya, dengan mengganti claude-sonnet-4-6. Kemudian lakukan perubahan berikut. Di Claude Sonnet 4.5 atau sebelumnya, lanjutkan dengan subbagian yang mengikutinya.
Perubahan yang merusak kompatibilitas
Pemikiran berjalan pada permintaan yang tidak menyertakannya. Lihat Pemikiran berjalan secara default dan Menonaktifkan pemikiran di awal.
Anggaran pemikiran mengembalikan error. Claude Sonnet 4.6 menerima thinking: {"type": "enabled", "budget_tokens": N} sebagai pengaturan yang usang. Claude Sonnet 4.5 dan Claude Haiku 4.5 menggunakannya untuk semua pemikiran. Claude Sonnet 5.5 mengembalikan error 400:
"thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.Hapus anggaran tersebut dan tetapkan tingkat effort. Tidak ada pemetaan tetap dari anggaran ke tingkat effort, jadi jalankan evaluasi Anda pada dua atau tiga tingkat.
Sebelum (Claude Sonnet 4.6):
client.messages.create(
model="claude-sonnet-4-6",
max_tokens=16000,
thinking={"type": "enabled", "budget_tokens": 10000},
messages=[{"role": "user", "content": "..."}],
)Sesudah (Claude Sonnet 5.5):
client.messages.create(
model="claude-sonnet-5-5",
max_tokens=16000,
thinking={"type": "adaptive"},
output_config={"effort": "high"}, # or "max", "xhigh", "medium", "low"
messages=[{"role": "user", "content": "..."}],
)Parameter sampling mengembalikan error. Claude Sonnet 4.6 dan model sebelumnya serta Claude Haiku 4.5 menerima temperature, top_p, dan top_k. Di Claude Sonnet 5.5, nilai yang bukan default mengembalikan error 400. Hapus parameter tersebut.
Teks pemikiran dihilangkan secara default. Lihat Menangani pemikiran dalam respons.
Perubahan lainnya
- Sekitar 30% lebih banyak token: Claude Sonnet 5.5 menggunakan tokenizer Claude Sonnet 5. Dibandingkan dengan Claude Sonnet 4.6, Claude Sonnet 4.5, dan Claude Haiku 4.5, teks yang sama menghasilkan sekitar 30% lebih banyak token, tergantung pada kontennya. Hitung ulang dengan penghitungan token, dan tinjau kembali
max_tokensserta biaya. - Effort:
xhighadalah tingkat baru, dan tingkat-tingkat lainnya telah dikalibrasi ulang. Lihat Perubahan yang direkomendasikan. - Gambar: Claude Sonnet 5.5 menggunakan tingkat gambar resolusi tinggi, hingga 2576 piksel pada sisi terpanjang dan 4.784 token visual per gambar. Claude Sonnet 4.6, Claude Sonnet 4.5, dan Claude Haiku 4.5 berhenti pada 1568 piksel dan 1.568 token. Gambar berukuran 2000×1500 memerlukan sekitar 2,5 kali lebih banyak token di Claude Sonnet 5.5. Lihat Resolusi dan biaya token.
Migrasi dari Claude Sonnet 4.5 atau sebelumnya
Di Claude Sonnet 4.5, Claude Sonnet 4, atau Claude 3.7 Sonnet, pertama terapkan setiap bagian sebelumnya, lalu perubahan berikut.
Prefill mengembalikan error. Claude Sonnet 5.5 menolak giliran asisten terakhir yang di-prefill dengan error 400, sama seperti Claude Sonnet 4.6 dan Claude Sonnet 5. Claude Sonnet 4.5, Claude Haiku 4.5, dan model yang lebih lama menerimanya. Error tersebut berbunyi:
This model does not support assistant message prefill. The conversation must end with a user message.Ganti setiap prefill sesuai dengan tujuannya:
- Format output: gunakan output terstruktur, atau alat dengan field enum untuk klasifikasi.
- Pembukaan: minta jawaban langsung di prompt sistem.
- Penolakan yang tidak diinginkan: instruksi yang jelas di pesan pengguna biasanya sudah cukup.
- Kelanjutan: pindahkan ke pesan pengguna, misalnya "Respons Anda sebelumnya terputus dan berakhir dengan
[previous_response]. Lanjutkan dari bagian terakhir." - Pengingat konteks: letakkan di giliran pengguna.
Escaping input alat. Escaping dalam argumen pemanggilan alat dapat berbeda. Parse input dengan parser JSON standar.
Computer use. Claude Sonnet 5.5 tidak menerima computer_20250124. Lihat tabel computer use.
Effort. Claude Sonnet 4.5 tidak memiliki parameter effort. Tetapkan tingkat effort secara eksplisit, seperti yang dijelaskan di Perubahan yang direkomendasikan.
Konteks dan output. Claude Sonnet 5.5 memiliki jendela konteks yang lebih besar, tanpa beta header, dan batas output yang lebih tinggi. Lihat halaman model. Hapus beta header jendela konteks apa pun.
Beta header. Hapus interleaved-thinking-2025-05-14, karena pemikiran adaptif menyisipkan pemikiran secara otomatis. Ganti fine-grained-tool-streaming-2025-05-14 dengan eager_input_streaming: true pada setiap alat yang memerlukannya. Header tersebut mengembalikan error 400 bila digunakan bersama entri toolset computer use atau browser use. Lihat Streaming alat yang terperinci.
Output terstruktur. Parameter output_format sudah usang dan akan dihapus di masa mendatang. Untuk tetap menggunakannya, tambahkan beta header structured-outputs-2025-11-13. Tanpa header tersebut, API mengembalikan error 400. Gunakan output_config.format sebagai gantinya.
Migrasi dari Claude Sonnet 4 atau sebelumnya
Claude Sonnet 4 telah dihentikan di Claude API dan masih tersedia di Amazon Bedrock dan Google Cloud. Claude 3.7 Sonnet telah dihentikan. Dari salah satu model tersebut, pertama terapkan setiap bagian sebelumnya, lalu perubahan berikut:
- Versi alat: Gunakan
text_editor_20250728, dengan nama alatstr_replace_based_edit_tooldan tanpa perintahundo_edit. Gunakancode_execution_20260521. Lihat alat text editor dan alat code execution. - Stop reason: Tangani
refusal. Claude 4.5 dan model yang lebih baru juga berhenti denganmodel_context_window_exceededpada batas jendela konteks. Lihat Menangani stop reason. - Baris baru di akhir: Claude 4.5 dan model yang lebih baru mempertahankannya dalam parameter string pemanggilan alat.
- Beta header lama: Hapus
token-efficient-tools-2025-02-19danoutput-128k-2025-02-19. - Prompt: Tinjau prompt Anda berdasarkan praktik terbaik prompting.
Migrasi ke Claude Sonnet 5.5 dari Claude Haiku 4.5
Pertama, terapkan setiap bagian hingga dan termasuk Migrasi dari Claude Sonnet 4.5 atau sebelumnya, dengan melewati subbagian Claude Sonnet 4. Kemudian lakukan perubahan berikut:
- ID model: Ganti
claude-haiku-4-5-20251001, atau aliasclaude-haiku-4-5, denganclaude-sonnet-5-5. - Biaya: Harga per token lebih tinggi, dan teks yang sama menghasilkan lebih banyak token. Hitung ulang token dan tetapkan ulang baseline biaya. Lihat harga Claude.
- Caching prompt: Prompt minimum yang dapat di-cache turun dari 4.096 token ke minimum Claude Sonnet 5.5.
- Pemikiran yang disisipkan: Pemikiran adaptif berjalan di antara pemanggilan alat secara otomatis, tanpa beta header.
- Routing: Claude Sonnet 5.5 membaca blok thinking Claude Haiku 4.5. Percakapan yang berpindah ke model yang lebih tinggi mempertahankan penalarannya. Percakapan yang kembali turun ke Claude Haiku 4.5 membuang blok milik Claude Sonnet 5.5.
Was this page helpful?