Cara Menggunakan API Claude Sonnet 5.5

TL;DR

Claude Sonnet 5.5 adalah model cepat untuk alur kerja pengkodean bercakupan jelas, dokumen, dan penggunaan alat. Anthropic melaporkan keluaran lebih cepat >30% dibanding Sonnet 5 pada tarif token standar yang sama. Mulailah dengan kunci CometAPI, ID model claude-sonnet-5-5, dan satu permintaan Messages atau Chat Completions yang kecil. Agen yang sudah ada sebaiknya uji ulang thinking, pemilihan alat, dan pemutaran ulang riwayat sebelum peluncuran.

Key Takeaways

• Gunakan Claude Sonnet 5.5 dan cocokkan format permintaan dengan endpoint Anda.
• Mulai dengan satu permintaan pendek sebelum menambahkan gambar, alat, atau konteks panjang.
• Gunakan Messages untuk kontrol khusus Claude; gunakan Chat Completions untuk aplikasi SDK OpenAI yang sudah ada.
• Tinjau perubahan thinking dan pemilihan alat sebelum memigrasikan loop agen yang ada.
• Bandingkan kualitas tugas yang diterima, latensi, penggunaan token, dan hit cache sebelum memperluas trafik.

What Is Claude Sonnet 5.5?

Claude Sonnet 5.5 API adalah antarmuka terprogram untuk model Sonnet 5.5 dari Anthropic. Dirancang untuk tugas seperti pengembangan perangkat lunak, analisis repositori, otomasi dukungan pelanggan, pemrosesan dokumen, pemahaman gambar, agen pengguna alat, dan alur kerja profesional terstruktur.

Anthropic memposisikan Sonnet 5.5 sebagai pelengkap yang lebih cepat dan lebih hemat biaya bagi Opus 5.5, model kedua dalam keluarga Claude 5.5, yang dioptimalkan untuk pengkodean bercakupan jelas, perbaikan bug, pembuatan dokumen dan slide, serta tugas profesional sehari-hari. Pengembang dapat mengakses Claude Sonnet 5.5 API di CometAPI menggunakan claude-sonnet-5-5.

Anthropic mengonfirmasi jendela konteks 1M token dan batas keluaran sinkron 128K. Keluaran batch dapat mencapai 300K token hanya melalui Message Batches dengan header beta output-300k-2026-03-24. Dukungan fitur Gateway harus diperiksa terpisah dari dukungan tingkat model.

How Does Claude Sonnet 5.5 Perform on Official Benchmarks?

Perbandingan ringkas di bawah ini membantu mengidentifikasi beban kerja yang perlu dievaluasi sebelum mengadopsi API. Hasil tolok ukur tidak menggantikan pengujian prompt dan loop alat Anda sendiri.

Hasil tolok ukur dan catatan evaluasi Anthropic menjadi dasar perbandingan ini. Hasil Terminal-Bench Opus 5.5 menggunakan effort Xhigh; FrontierCode melaporkan hasil Max dan Xhigh terpisah untuk Sonnet 5.5; OSWorld adalah evaluasi parsial. GDPval-AA dan AA-Briefcase dijalankan oleh Artificial Analysis pada penerapan Claude Platform pra-rilis dengan bug keluaran terstruktur yang kemungkinan menurunkan skor Sonnet 5.5; Anthropic menyatakan bug tersebut telah diperbaiki. Hasil ini sebaiknya menjadi panduan pengujian beban kerja, bukan jaminan hasil produksi. Humanity’s Last Exam menggunakan alat; Chartography tidak. Baris baru menggunakan skor yang dipublikasikan Anthropic. Gambar asli di bawah tetap dipertahankan; tabel yang diperluas mencakup tiga evaluasi tambahan.

Perbandingan tolok ukur resmi Claude Sonnet 5.5

What Changed in Claude Sonnet 5.5 API From Sonnet 5?

Perubahan migrasi untuk thinking, pemilihan alat, dan pemutaran riwayat memengaruhi loop agen yang ada. Tabel merangkum perubahan operasional ini; ini bukan inventaris fitur yang lengkap.

Breaking Changes to Check

Periksa kelima perubahan pemutus: ganti thinking disabled dengan between_tools; hapus pemaksaan pemilihan alat; pertahankan blok thinking yang kompatibel dan riwayat percakapan yang tidak berubah; migrasikan computer_20251124 ke computer_toolset_20260801 pada Claude API dan Google Cloud; serta ganti pendamping (advisor) yang tidak didukung. Amazon Bedrock masih menerima computer_20251124. Advisor yang tidak didukung termasuk Opus 4.8, 4.7, 4.6, Sonnet 5, Sonnet 4.6, dan Haiku 5.5. Opus 5.5 adalah salah satu pengganti yang didukung. Baca blok respons berdasarkan tipe. Verifikasi kompatibilitas platform dan gateway sebelum peluncuran. Panduan migrasi resmi.

Additional Capabilities and Workflow Changes

Gunakan panduan fitur resmi untuk meninjau pembaruan progres, effort per pesan, dan kontrol di tengah percakapan. Konfirmasikan dukungan gateway sebelum mengaktifkan fitur beta.

What Do You Need Before Using the Claude Sonnet 5.5 API?

• Akun CometAPI, kunci API, akses model, dan saldo penagihan yang tersedia.
• Terminal dengan cURL; Python dan pip atau Node.js dan npm untuk contoh SDK.
• Endpoint yang dipilih: /v1/messages atau /v1/chat/completions.
• COMETAPI_KEY disimpan di lingkungan server, plus akses jaringan ke https://api.cometapi.com.
• Prompt uji singkat dan pemeriksaan jelas untuk keluaran yang dapat digunakan, status penyelesaian, dan penggunaan token.

How Do You Access Claude Sonnet 5.5 API Through CometAPI?

Pilih Messages API ketika perilaku Claude itu sendiri penting. Pilih API kompatibel OpenAI ketika aplikasi Anda sudah beralih di antara Claude, GPT, Gemini, DeepSeek, atau model lain melalui lapisan abstraksi yang sama.

Step 1: Store the API Key

Buat kunci di konsol kunci API CometAPI, lalu atur di lingkungan runtime Anda.

Set the CometAPI key in a POSIX shell

export COMETAPI_KEY="YOUR_COMETAPI_KEY"

Set the CometAPI key in PowerShell

$env:COMETAPI_KEY="YOUR_COMETAPI_KEY"

Step 2: Make the First Messages Request

Send the first Anthropic-compatible Messages request

curl https://api.cometapi.com/v1/messages \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 2048,
    "messages": [{"role": "user", "content": "Explain exponential backoff in three bullet points."}]
  }'

Periksa blok konten, stop_reason, dan usage sebelum menambahkan lebih banyak kontrol. Sintaks cURL di atas menggunakan shell POSIX.

Step 3: Use the Anthropic Python SDK

Install the Anthropic Python SDK

pip install anthropic

Read text blocks and usage with the Anthropic SDK

import os
import anthropic

anthropic_client = anthropic.Anthropic(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com",
)

response = anthropic_client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=4096,
    messages=[{"role": "user", "content": "Review this migration plan and list the three biggest risks."}],
)

for block in response.content:
    if block.type == "text":
        print(block.text)
print("Completion:", response.stop_reason)
print("Usage:", response.usage)

Step 4: Use the OpenAI Python SDK

Install the OpenAI Python SDK

pip install openai

Call Sonnet 5.5 through OpenAI-compatible Chat Completions

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com/v1",
)

response = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[
        {
            "role": "system",
            "content": "You are a concise software engineering assistant."
        },
        {
            "role": "user",
            "content": "Review this function and identify the highest-risk bug."
        }
    ],
)

print(response.choices[0].message.content)

Pendekatan ini berguna ketika aplikasi sudah menggunakan antarmuka SDK OpenAI. Integrasi teks dasar mungkin hanya memerlukan URL basis baru, kunci API, dan ID model, tetapi migrasi produksi tetap harus memverifikasi parameter yang didukung, format respons, pemanggilan alat, event streaming, batas waktu, dan perhitungan token.

Step 5: Use JavaScript in Node.js

Install the OpenAI Node.js SDK

npm install openai

Call Sonnet 5.5 from a Node.js ES module

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.COMETAPI_KEY,
  baseURL: "https://api.cometapi.com/v1",
});

const response = await client.chat.completions.create({
  model: "claude-sonnet-5-5",
  messages: [
    {
      role: "user",
      content: "Create a TypeScript function that validates an email address.",
    },
  ],
});

console.log(response.choices[0].message.content);

Untuk aplikasi backend Node.js, simpan COMETAPI_KEY di lingkungan server alih-alih mengirimkannya ke klien browser.

Claude Sonnet 5.5 Thinking and Effort Levels

API baku pada effort tinggi; aplikasi Claude dan Claude Code menggunakan medium. Pilih effort berdasarkan kualitas tugas yang diterima, latensi, dan biaya token. Tabel di bawah ini adalah titik awal editorial, bukan klasifikasi beban kerja resmi.

Hindari otomatis menetapkan pengaturan effort tertinggi untuk setiap permintaan. Beban kerja agen dapat menjadi jauh lebih mahal ketika penalaran tambahan juga memicu lebih banyak panggilan alat dan keluaran lebih panjang. Pilih pengaturan dengan evaluasi tingkat tugas. Gunakan adaptive thinking untuk Xhigh dan Max, lalu bandingkan kualitas tugas yang diterima dan total biaya dengan level yang lebih rendah. Panduan effort resmi.

Configure Effort Through Messages

Contoh ini menggunakan klien Anthropic yang diinisialisasi di atas. Uji kontrol yang sama pada rute CometAPI Anda sebelum peluncuran.

Konfigurasikan adaptive thinking dan effort high

response = anthropic_client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=8192,
    thinking={"type": "adaptive"},
    output_config={"effort": "high"},
    messages=[{"role": "user", "content": "Audit this service migration plan."}],
)

Turn Off Up-Front Thinking

Gunakan thinking={"type": "between_tools"} pada effort low, medium, atau high. Gunakan adaptive thinking untuk xhigh atau max. between_tools tidak memiliki field display atau budget_tokens dan tidak mengizinkan perubahan effort di tengah percakapan.

Preserve Thinking in Tool Loops

Kembalikan blok konten asisten asli sebelum menambahkan hasil alat. Thinking yang dipertahankan bergantung pada model, prefix percakapan, dan akun yang menghasilkan. Binding prefix diberlakukan secara default pada Claude API, Amazon Bedrock, dan Google Cloud untuk akun yang dibuat pada atau setelah 31 Agustus 2026, 00:00 UTC. Jangan berasumsi setiap gateway mengekspos kontrol binding yang sama.

How to Stream Claude Sonnet 5.5 Responses

Stream Long Responses

Streaming bermanfaat untuk antarmuka chat, asisten pengkodean, dan respons panjang karena pengguna dapat melihat keluaran sebelum generasi selesai.

Stream text through OpenAI-compatible Chat Completions

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com/v1",
)

stream = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[
        {
            "role": "user",
            "content": "Explain how a retrieval-augmented generation pipeline works."
        }
    ],
    stream=True,
)

for chunk in stream:
    if not chunk.choices:
        continue
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

Streaming biasanya tidak mengurangi jumlah total token yang dihasilkan. Manfaat utamanya adalah latensi yang terasa. Aplikasi juga harus menangani stream yang terputus, keluaran parsial, retry jaringan, dan pembatalan secara eksplisit.

Use Tools With Automatic Selection

Gunakan tool_choice={"type": "auto"}. Validasi setiap nama alat dan argumen, terapkan otorisasi dan batas waktu, kembalikan hasil terstruktur, dan batasi iterasi. Eksekusi alat yang wajib sebaiknya berada di orkestrasi aplikasi.

Define a ticket lookup tool and request automatic selection

tools = [{
    "name": "lookup_ticket",
    "description": "Retrieve a support ticket by ID",
    "input_schema": {
        "type": "object",
        "properties": {"ticket_id": {"type": "string"}},
        "required": ["ticket_id"],
        "additionalProperties": False,
    },
}]

response = anthropic_client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=4096,
    tools=tools,
    tool_choice={"type": "auto"},
    messages=[{"role": "user", "content": "Look up ticket T-123 and summarize its status."}],
)

Blok tool_use meminta sebuah tindakan; panggilan pertama ini tidak mengeksekusinya. Validasi permintaan di server Anda, jalankan operasi, tambahkan konten asisten tanpa perubahan, dan kirim tool_result yang cocok. Skema pada contoh ini tetap memerlukan validasi aplikasi; dukungan alat yang ketat harus diperiksa pada rute yang dipilih.

Use Prompt Caching for Repeated Context

Prompt caching berguna ketika permintaan berulang kali berisi prefix besar yang sama, seperti kebijakan sistem, skema alat, peta repositori, dokumentasi produk, instruksi yang dapat digunakan kembali, atau manual referensi.

Sonnet 5.5 memerlukan prefix prompt yang dapat di-cache minimal 512 token. Prefix yang lebih pendek diproses tanpa caching, bahkan dengan cache_control. Periksa cache_creation_input_tokens dan cache_read_input_tokens; keduanya nol berarti cache tidak digunakan. Konfirmasikan dukungan pada rute gateway Anda. Referensi prompt caching.

Arrange stable context before dynamic request content

Stable system instructions
Stable tools
Stable repository or knowledge context
---------------- cache boundary ----------------
Current user request
Current retrieved context

Tarif cache-read CometAPI saat ini adalah $0.16 per satu juta token, dibanding $1.60 untuk input baru. Penulisan cache ditagihkan terpisah. Verifikasi hit cache dalam metadata usage sebelum memperkirakan penghematan.

Caching sangat berguna untuk agen pengkodean dan asisten enterprise yang menggunakan ulang prefix konteks besar di berbagai giliran. Namun, ekonominya tetap bergantung pada hit cache aktual; sering menulis ulang prefix stabil dapat menghilangkan sebagian besar manfaat yang diharapkan.

Send Images Using the Selected Endpoint Schema

Sonnet 5.5 menerima input teks dan gambar. JSON di bawah adalah payload Chat Completions yang kompatibel dengan OpenAI; ganti URL gambar contoh dengan gambar yang dapat diakses publik dan Anda kuasai. Messages menggunakan skema blok gambar yang berbeda.

Send an image in a Chat Completions payload

{
  "model": "claude-sonnet-5-5",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Find the three most important UI problems in this screenshot."
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/interface.png"
          }
        }
      ]
    }
  ]
}

Bentuk permintaan multimodal yang tepat bisa berbeda antara antarmuka native Claude dan kompatibel OpenAI, jadi gunakan skema untuk endpoint yang benar-benar Anda terapkan alih-alih mengasumsikan kedua format dapat dipertukarkan.

Handle Safeguards and Retained Data

Catat penolakan dan perilaku fallback sebagai status aplikasi eksplisit. Anthropic menjelaskan tindakan pengaman (safeguards) dan ketersediaan zero-data-retention untuk layanannya. Verifikasi pengaturan retensi dan routing yang berlaku di gateway Anda secara terpisah sebelum mengirim materi produksi.

Claude Sonnet 5.5 vs Sonnet 5 vs Opus 5.5

Label kualitatif di bawah ini adalah panduan routing editorial berdasarkan cakupan tugas, bukan nilai kinerja resmi. Validasi peran ini pada beban kerja yang representatif. Rincian arsitektur tidak disimpulkan dari skor tolok ukur.

Route difficult tasks to an escalation model

Routine task
    ↓
Claude Sonnet 5.5
    ↓
Confidence / validation failure?
    ├── No → Return result
    └── Yes → Escalate difficult case
                 ↓
              Opus-class model

Pola routing ini dapat mengurangi biaya sambil mempertahankan akses ke tier penalaran yang lebih kuat untuk kasus sulit.

Claude Sonnet 5.5 Pricing Through CometAPI

Diperiksa 10 Oktober 2026: input/output CometAPI tetap $1.60/$8 per satu juta token, 20% di bawah $2/$10 milik Anthropic. Cache read/write CometAPI tetap $0.16/$2; cache read/write Anthropic saat ini $0.10/$2.50 untuk penulisan lima menit. Halaman peluncuran masih menampilkan cache read $0.20; revisi ini menggunakan referensi caching saat ini. Harga gateway dapat berubah secara independen.

Perbedaan antara harga token dan biaya tugas penting untuk aplikasi agen. Agen pengkodean mungkin menghasilkan lebih sedikit token tetapi tetap melakukan beberapa putaran panggilan alat, cache read, inspeksi kode, retry, dan validasi. Biaya per tugas yang berhasil diselesaikan biasanya lebih informatif daripada harga token input semata.

Estimate fresh-input and output-token charges

Input:
100,000 / 1,000,000 × $1.60 = $0.16

Output:
5,000 / 1,000,000 × $8.00 = $0.04

Estimated model-token cost:
$0.20

Biaya alat, operasi cache, langkah agen berulang, atau fitur lain yang ditagihkan dapat mengubah biaya akhir.

Tarif diperiksa ulang 10 Oktober 2026 terhadap halaman model CometAPI saat ini. Harga input/output baru tidak berubah, sehingga contoh perhitungan tetap $0.16 + $0.04 = $0.20 untuk 100,000 input baru dan 5,000 token output. Ini tidak termasuk penulisan cache, pembacaan cache, biaya alat, dan retry. Periksa ulang penagihan spesifik rute sebelum membuat anggaran.

Control Cost per Accepted Task

Ada beberapa cara praktis untuk mengurangi pengeluaran tanpa langsung mengganti model. Pertama, definisikan kriteria penyelesaian dengan jelas:

Define a focused response acceptance format

Return only:
1. the root cause;
2. the affected file;
3. the smallest safe fix;
4. one regression test.

Kedua, pangkas konteks yang diambil sebelum mengirimnya. Jendela konteks 1M token adalah batas kapasitas, bukan target. Ketiga, gunakan ulang konteks stabil melalui prompt caching. Keempat, pilih effort berdasarkan beban kerja alih-alih mengatur High untuk setiap permintaan. Kelima, ukur biaya per tugas yang diterima:

Calculate cost per accepted task

Total API cost
÷
Number of outputs accepted without rework

Permintaan yang lebih murah tidak serta-merta berarti alur kerja lebih murah jika menyebabkan retry, koreksi, atau panggilan alat ekstra.

How Do You Migrate From Sonnet 5 to Claude Sonnet 5.5 API?

1. Simpan konfigurasi produksi sebelumnya untuk rollback.
2. Ganti ID model dari claude-sonnet-5 ke claude-sonnet-5-5.
3. Terapkan perubahan pada thinking, pemilihan alat otomatis, dan riwayat.
4. Putar ulang permintaan representatif, termasuk alat, gambar, dan streaming.
5. Bandingkan keluaran yang diterima, tingkat koreksi manusia, latensi p50/p95, dan total biaya tugas.
6. Uji retry, penolakan, pembatalan, dan stream yang terputus.
7. Verifikasi hit cache dan perilaku anggaran keluaran dari metadata usage.
8. Luncurkan kanari trafik kecil dan perluas hanya setelah ambang penerimaan terpenuhi.

Troubleshooting Claude Sonnet 5.5 API Errors

Jangan me-retry permintaan yang rusak atau kegagalan autentikasi tanpa perubahan. Cegah tindakan alat duplikat saat memutar ulang run agen yang terputus.

Claude Sonnet 5.5 Production Best Practices

Pilih beban kerja, definisikan gerbang penerimaan, dan evaluasi aplikasi secara menyeluruh. Catat ID model, endpoint, effort, latensi, penggunaan token dan cache, kegagalan alat, status penyelesaian, dan hasil tugas yang diterima. Simpan kunci di sisi server dan konfigurasikan batas waktu, retry terbatas, dan batas iterasi agen.

Measure Workflow Quality and Reliability

Untuk agen pengkodean, lacak juga tes yang lulus, file yang diubah tanpa perlu, patch yang dibatalkan, dan penyelesaian sukses tanpa intervensi manusia.

Example: Fix a Well-Scoped Repository Bug

Sediakan tes yang gagal, file sumber terkait, dan perilaku yang diharapkan. Minta patch terfokus dengan pemeriksaan regresi. Gerbang penerimaan adalah perbaikan yang dapat direproduksi, lulus tes terkait, dan tanpa edit tidak terkait. Bandingkan total biaya API dan alat terhadap patch yang diterima.

Example: Triage a Support Ticket

Ambil masalah pelanggan dan cuplikan basis pengetahuan yang disetujui. Minta model mengklasifikasikan masalah, menyusun respons berbasis bukti, dan menandai kasus yang memerlukan eskalasi. Terima hasil hanya ketika klaimnya cocok dengan materi yang diambil dan keputusan routing mengikuti kebijakan dukungan.

Example: Review a Document and Screenshot

Sediakan prosedur yang disetujui dan tangkapan layar antarmuka yang sesuai. Minta ketidaksesuaian dengan referensi ke bagian relevan dan elemen UI yang terlihat. Wajibkan peninjau mengonfirmasi temuan sebelum mengubah prosedur.

Conclusion

Claude Sonnet 5.5 memberi tim kandidat praktis untuk alur kerja pengkodean, dukungan, dokumen, dan penggunaan alat yang cepat. Mulailah dengan permintaan CometAPI yang berfungsi, lalu tambahkan kontrol yang diperlukan aplikasi Anda.

Migrasi membutuhkan lebih dari sekadar mengganti ID model: periksa pengaturan thinking, pemilihan alat otomatis, parsing respons, dan pemutaran riwayat. Promosikan model saat evaluasi beban kerja Anda menunjukkan keseimbangan yang dapat diterima antara kualitas, latensi, dan biaya; sediakan tier yang lebih kuat untuk tugas yang gagal melewati gerbang penerimaan Anda.

FAQ

How Should Teams Rotate a Claude Sonnet 5.5 API Key Without Downtime?

Simpan kunci di pengelola rahasia sisi server dan biarkan worker memuat ulang kredensial tanpa menanamkannya di kode aplikasi. Jika penyedia mendukung kunci aktif yang tumpang tindih, perkenalkan pengganti terlebih dahulu, validasi permintaan kecil, alihkan worker secara bertahap, lalu cabut kunci sebelumnya. Pantau kesalahan autentikasi selama perubahan dan hindari mencatat kedua kunci.

How Can a Claude Sonnet 5.5 Job Resume After a Worker Restart?

Persistenkan pengenal job, langkah terakhir yang diselesaikan, konfigurasi permintaan, dan catatan eksekusi alat. Lanjutkan dari titik pemeriksaan yang terverifikasi. Sebelum memutar ulang tindakan alat, periksa apakah sudah selesai dan apakah aman untuk diulang. Transkrip yang disimpan saja tidak mencegah tiket, pesan, atau penulisan database ganda.

How Should Teams Detect Claude Sonnet 5.5 Behavior Changes Over Time?

Simpan set evaluasi bertanggal dengan jawaban yang diterima atau pemeriksaan penerimaan, beserta versi SDK dan pengaturan permintaan. Jalankan ulang secara berkala dan setelah perubahan penyedia, SDK, prompt, atau routing. Bandingkan keberhasilan tugas, tingkat koreksi, latensi, dan total biaya. Jika akun menawarkan version pinning, konfirmasikan jaminannya sebelum mengandalkannya; simpan rute rollback untuk alur kerja kritis.