Panduan model dan modalitas21 Oktober 2026Flatkey Team

Claude Sonnet API (2026): ID Model, Pengaturan, Batas, dan Kode untuk Sonnet 5.5

Semua yang Anda perlukan untuk memanggil Claude Sonnet 5.5 lewat API: ID model, kunci, kode siap pakai, effort dan thinking, rate limit, biaya, serta perbaikan migrasi.

Claude Sonnet API (2026): ID Model, Pengaturan, Batas, dan Kode untuk Sonnet 5.5

Untuk memakai Claude Sonnet API, buat API key Anthropic lalu kirim permintaan ke https://api.anthropic.com/v1/messages dengan ID model claude-sonnet-5-5, model Sonnet terbaru yang dirilis pada 28 September 2026. Model ini memiliki jendela konteks 1M token, output maksimum 128K, adaptive thinking aktif secara default, dan berharga $2 per juta token input serta $10 per juta token output menurut harga resmi Anthropic per 21 Oktober 2026. Jika Anda memindahkan kode dari Sonnet 4.6 atau versi lebih lama, lima parameter yang dulu berfungsi kini mengembalikan error 400; daftarnya ada di bawah.

Panduan ini ditujukan bagi developer yang membangun produk di atas Claude: ID model Sonnet mana yang dipanggil, cara mendapatkan kunci, kode siap jalan dalam curl, Python, dan Node.js, rate limit per tier, serta perubahan yang tidak kompatibel dan sering menggagalkan migrasi. Untuk rincian biaya semua model Claude, lihat panduan harga Claude API kami.

Model Claude Sonnet yang tersedia lewat API

Model	ID model API	Status (21 Okt 2026)	Konteks / output maks.	Input / output per 1M token	Baca cache
Claude Sonnet 5.5	`claude-sonnet-5-5`	Terbaru, dirilis 28 Sep 2026	1M / 128K	$2 / $10	$0.10
Claude Sonnet 5	`claude-sonnet-5`	Legacy	lihat dokumentasi model	$2 / $10	$0.20
Claude Sonnet 4.6	`claude-sonnet-4-6`	Legacy	lihat dokumentasi model	$3 / $15	$0.30
Claude Sonnet 4.5	`claude-sonnet-4-5-20250929`	Usang, dihentikan 30 Nov 2026	lihat dokumentasi model	$3 / $15	$0.30

Harga dari halaman harga Anthropic; status model dari ikhtisar model dan halaman penghentian model; spesifikasi Sonnet 5.5 dari ikhtisar Sonnet 5.5, semuanya diperiksa pada 21 Oktober 2026.

Mana yang dipanggil: gunakan claude-sonnet-5-5 untuk proyek baru. Menurut panduan migrasi, harganya per token sama dengan Sonnet 5, tetapi baca cache hanya setengahnya ($0,10 vs $0,20 per juta). Dibandingkan Sonnet 4.6 ($3 / $15), Sonnet 5.5 lebih murah per token, tetapi perhatikan tokenizer-nya: Anthropic menyebut Sonnet 5.5 menghasilkan sekitar 30% lebih banyak token dibanding Sonnet 4.6 untuk teks yang sama, jadi bandingkan jumlah token nyata, bukan hanya harga daftar. Pengguna Sonnet 4.5 harus bermigrasi sebelum model itu dihentikan pada 30 November 2026.

Sekilas Sonnet 5.5

Spesifikasi	Nilai	Sumber
ID model (Claude API, Google Cloud, Microsoft Foundry, Claude Platform on AWS)	`claude-sonnet-5-5`	Ikhtisar
ID model Amazon Bedrock	`anthropic.claude-sonnet-5-5`	Ikhtisar
Jendela konteks	1M token	Ikhtisar
Output maksimum	128K token; 300K di Batch API dengan header beta `output-300k-2026-03-24`	Ikhtisar
Modalitas	Teks dan gambar masuk, teks keluar	Ikhtisar
Thinking	Adaptif, aktif secara default; pengaturan terendah `between_tools`	Ikhtisar
Effort default	`high`	Ikhtisar
Batas pengetahuan	Juni 2026	Ikhtisar
Penghentian	Tidak lebih awal dari 28 September 2027	Ikhtisar

Cara mendapatkan Claude Sonnet API key

Masuk ke Claude Console dan buka API keys.
Buat kunci, salin sekali saja, lalu simpan sebagai ANTHROPIC_API_KEY di environment atau secret manager Anda.
Tambahkan kredit atau metode pembayaran. Tier penggunaan (dan rate limit) naik seiring pengeluaran; lihat bagian rate limit di bawah.

Satu kunci berlaku untuk semua model Claude, jadi tidak ada "Sonnet API key" terpisah. Jika Anda ingin satu kunci untuk Claude, GPT, Gemini, dan DeepSeek, API terpadu seperti Flatkey menerbitkan satu kunci untuk semuanya (dibahas di akhir).

Permintaan pertama Anda ke Claude Sonnet 5.5

Permintaan di bawah mengikuti contoh resmi Anthropic dalam panduan migrasi Sonnet 5.5. Permintaan ini menetapkan tingkat effort dan menghindari semua parameter yang mengembalikan 400 pada model ini.

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 4096,
    "messages": [{"role": "user", "content": "Write a SQL query that finds churned customers in the last 30 days."}],
    "output_config": {"effort": "medium"}
  }'

Python, dengan SDK resmi anthropic:

# pip install anthropic
import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY

response = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=4096,
    messages=[{"role": "user", "content": "Write a SQL query that finds churned customers in the last 30 days."}],
    output_config={"effort": "medium"},
)

print("stop_reason:", response.stop_reason)
for block in response.content:
    if block.type == "text":  # adaptive thinking may add thinking blocks first
        print(block.text)

Node.js dengan @anthropic-ai/sdk:

// npm install @anthropic-ai/sdk
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic(); // reads ANTHROPIC_API_KEY

const response = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 4096,
  messages: [{ role: "user", content: "Write a SQL query that finds churned customers in the last 30 days." }],
  output_config: { effort: "medium" },
});

const text = response.content.find((b) => b.type === "text");
console.log(response.stop_reason, text?.text);

Baca respons berdasarkan jenis blok. Saat adaptive thinking aktif, blok konten pertama bisa berupa blok thinking, jadi response.content[0].text tidak aman dipakai di Sonnet 5.5.

Effort dan thinking di Sonnet 5.5

Sonnet 5.5 mengganti anggaran thinking tetap dengan pengaturan effort di dalam output_config (dokumentasi effort). Default-nya high. Panduan migrasi Anthropic menunjukkan tingkat low, medium, high, xhigh, dan max.

Yang Anda inginkan	Kirim	Catatan dari dokumentasi Anthropic
Perilaku default	tidak ada, atau `thinking: {"type": "adaptive"}`	Adaptive thinking aktif secara default
Jawaban lebih murah dan cepat	`output_config: {"effort": "low"}` atau `"medium"`	Effort lebih rendah berarti token output lebih sedikit
Tanpa thinking di awal	`thinking: {"type": "between_tools"}`	Diterima pada `low`, `medium`, `high`; mengembalikan 400 pada `xhigh` atau `max`
Masalah paling sulit	`output_config: {"effort": "xhigh"}` atau `"max"`	Gunakan adaptive thinking, bukan `between_tools`

thinking: {"type": "disabled"} tidak diterima di Sonnet 5.5; between_tools adalah pengaturan terendah (panduan migrasi).

Parameter yang kini mengembalikan error 400

Jika Anda upgrade dari Sonnet 4.6 atau lebih lama, hapus parameter berikut. Kelimanya tercantum dalam panduan migrasi Sonnet 5.5 dari Anthropic:

Parameter lama	Di Sonnet 5.5	Ganti dengan
`thinking: {"type": "enabled", "budget_tokens": N}`	Error 400	`output_config.effort`
`temperature`, `top_p`, `top_k`	Error 400	Instruksi di prompt; effort
Prefill asisten (pesan terakhir dari `assistant`)	Error 400	Structured output atau instruksi sistem
`tool_choice` paksa (`any` atau tool tertentu)	Error 400	`auto` plus instruksi tool yang jelas
`thinking: {"type": "disabled"}`	Error 400	`thinking: {"type": "between_tools"}`

Periksa juga max_tokens dan estimasi biaya karena jumlah token naik sekitar 30% dibanding Sonnet 4.6. Jika muncul error ID model setelah upgrade, panduan Claude: versi model tidak ditemukan dan error 400 Anthropic kami membahas penyebab umumnya.

Rate limit Claude Sonnet API

Anthropic memublikasikan batas per tier di halaman rate limit. Untuk Sonnet 5.5, per 21 Oktober 2026:

Tier	Permintaan per menit	Token input per menit	Token output per menit
Start	1.000	2.000.000	400.000
Build	5.000	5.000.000	1.000.000
Scale	10.000	10.000.000	2.000.000

Sonnet 5, Sonnet 4.x, dan Haiku 5.5 memiliki angka yang sama per tier. Anthropic mencatat bahwa untuk sebagian besar model, token input yang dibaca dari cache tidak dihitung dalam batas token input per menit, sehingga prompt caching berguna untuk menghemat biaya sekaligus melonggarkan rate limit.

Berapa biaya Sonnet 5.5 dalam praktik

Harga resmi per 21 Oktober 2026, per 1M token (harga):

Item	Harga
Input	$2.00
Output	$10.00
Tulis cache, 5 menit	$2.50
Tulis cache, 1 jam	$4.00
Baca cache	$0.10
Batch API input / output	$1.00 / $5.00
Inferensi khusus AS (`inference_geo`)	1,1x semua harga token

Contoh perhitungan: asisten dukungan pelanggan menangani 50.000 permintaan per bulan, masing-masing dengan system prompt ter-cache 3.000 token, 500 token input baru, dan 400 token output. Baca cache: 150 juta token × $0,10 = $15. Input baru: 25 juta × $2 = $50. Output: 20 juta × $10 = $200. Total sekitar $265 per bulan, belum termasuk penulisan cache satu kali. Output mendominasi, sehingga effort lebih berpengaruh daripada optimasi input. Untuk perbandingan per model, lihat harga Claude API dan routing API Claude vs GPT.

Memakai Claude Sonnet dengan OpenAI SDK

Anthropic menyediakan endpoint yang kompatibel dengan OpenAI di https://api.anthropic.com/v1/, tetapi halaman kompatibilitas OpenAI SDK menyebutnya untuk pengujian dan perbandingan, bukan untuk sebagian besar penggunaan produksi: parameter strict pada function calling diabaikan, response_format diabaikan, dan prompt caching tidak didukung. Untuk produksi dengan Sonnet 5.5, gunakan Messages API native di atas. Artikel kami tentang kompatibilitas Claude API dengan OpenAI SDK membahas pilihannya secara rinci.

Satu kunci untuk Sonnet dan model lain: Flatkey

Jika produk Anda juga memanggil GPT, Gemini, atau DeepSeek, Flatkey memberi Anda satu kunci dan satu saldo prabayar untuk semuanya. Pada 21 Oktober 2026, halaman model Claude Sonnet 5.5 di Flatkey mencantumkan $1,60 input / $8,00 output per 1M token, 20% di bawah $2 / $10 milik Anthropic, dan Sonnet 4.6 seharga $2,40 / $12,00. SDK Anthropic dapat dipakai cukup dengan mengganti base URL menjadi https://router.flatkey.ai (tanpa /v1), sesuai panduan Anthropic SDK dari Flatkey:

import anthropic

client = anthropic.Anthropic(api_key="YOUR_FLATKEY_KEY", base_url="https://router.flatkey.ai")
msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Draft a release note for v2.3."}],
)
print(next(b.text for b in msg.content if b.type == "text"))

Untuk pengaturan Claude Code, lihat pengaturan API router untuk Claude Code. Gunakan Anthropic langsung jika Anda membutuhkan fitur atau kontrak yang hanya ada di platform mereka, seperti header beta tertentu pada hari peluncuran atau perjanjian enterprise.

FAQ

Apa nama model Claude Sonnet API?

Per 21 Oktober 2026, ID model terbaru adalah claude-sonnet-5-5 di Claude API, Google Cloud, Microsoft Foundry, dan Claude Platform on AWS, serta anthropic.claude-sonnet-5-5 di Amazon Bedrock. ID lama antara lain claude-sonnet-5 dan claude-sonnet-4-6.

Berapa harga Claude Sonnet API?

Claude Sonnet 5.5 berharga $2 per juta token input dan $10 per juta token output, dengan baca cache $0,10 dan Batch API setengah harga ($1 / $5), menurut halaman harga Anthropic yang diperiksa pada 21 Oktober 2026.

Apakah Claude Sonnet API gratis?

Tidak. API Anthropic dibayar per token; tidak ada tier API gratis untuk Sonnet. Aplikasi Claude untuk konsumen memiliki paket gratis dan berbayar sendiri yang terpisah dari tagihan API. Untuk opsi gratis dari penyedia lain, lihat panduan API LLM gratis kami.

Berapa jendela konteks Claude Sonnet 5.5?

1M token, dengan output hingga 128K token per permintaan, atau 300K di Message Batches API dengan header beta output-300k-2026-03-24.

Mengapa permintaan Sonnet saya mengembalikan error 400 setelah upgrade?

Sonnet 5.5 menolak anggaran thinking, temperature/top_p/top_k, prefill asisten, pemilihan tool paksa, dan thinking: {"type": "disabled"}. Hapus parameter tersebut dan gunakan output_config.effort atau thinking: {"type": "between_tools"}.

Apakah ada Claude Sonnet 5 API?

Ada. claude-sonnet-5 masih bisa dipanggil sebagai model legacy dengan harga $2 / $10 per juta token, baca cache $0,20. Sonnet 5.5 memiliki harga token yang sama dan baca cache setengah harga, sehingga menjadi pilihan default yang lebih baik untuk proyek baru.