Cara Menggunakan Claude Fable 5.1 API

Ringkasan cepat: Untuk menggunakan Claude Fable 5.1 API di CometAPI, siapkan kunci API, setel ID model ke claude-fable-5-1, dan validasi permintaan kecil sebelum membangun alur kerja yang lebih panjang. Panduan ini membahas akses, effort, streaming, tools, cache, migrasi, dan pemeriksaan produksi. Perlakukan deployment sebagai lebih dari sekadar mengganti string model: konfirmasi kompatibilitas rute, validasi output, dan ukur kualitas tugas yang diterima, latensi, serta biaya sebelum memperluas penggunaan.

Pokok Utama

• Buat satu permintaan berfungsi dulu: konfirmasi kredensial, akses model, endpoint yang dipilih, dan respons yang dapat digunakan dengan data uji non-sensitif.
• Pilih effort secara sengaja: mulai pada high, lalu bandingkan pengaturan lain pada tugas representatif alih-alih menggunakan effort maksimum untuk setiap permintaan. Claude Code default ke High. Claude Cowork / Claude.ai default ke Medium
• Tinjau perilaku migrasi: pemaksaan pemilihan tool ditolak; pertahankan langkah alur kerja yang wajib dan validasi argumen tool dalam kode aplikasi.
• Ukur alur kerja lengkap: lacak penggunaan cache, biaya token, latensi, penolakan, perilaku fallback, dan apakah hasil akhir lulus pemeriksaan penerimaan Anda.

Untuk latar belakang, lihat pelacak Fable 5.1 sebelumnya CometAPI dan tutorial Fable 5 API. Artikel ini berfokus pada alur integrasi saat ini.

Apa Itu Claude Fable 5.1?

Claude Fable 5.1 adalah model kemampuan tertinggi Anthropic yang tersedia secara umum untuk coding ambisius, riset multilangkah, penggunaan komputer, dan alur kerja profesional yang sarat dokumen. Anthropic merekomendasikan memulai sebagian besar beban kerja dengan Claude Opus 5 dan meningkatkan ke Fable 5.1 ketika evaluasi Opus ber-effort tinggi masih belum memadai.

Perbedaannya bersifat operasional: Fable 5.1 dirancang untuk terus bekerja di lintas langkah saling bergantung, pulih setelah panggilan tool gagal, memverifikasi hasil, dan melaporkan progres selama proses panjang. Itu dapat meningkatkan tingkat penyelesaian, tetapi juga membuat biaya, latensi, dan keteramatan menjadi pusat dalam deployment.

Spesifikasi API Claude Fable 5.1

Ringkasan resmi mengonfirmasi jendela konteks 1M dan output maksimum 128K. Thinking adaptif selalu aktif; kedalaman penalaran dikendalikan dengan effort daripada anggaran thinking-token tradisional.

Kinerja Benchmark Resmi Claude Fable 5.1 API

Ringkasan benchmark sengaja singkat karena tujuan utama artikel ini adalah implementasi. Hasil di bawah menyoroti di mana premium API paling mungkin berdampak.

Perbandingan tolok ukur resmi Claude Fable 5.1 oleh Anthropic

Kenaikan generasional terbesar dalam set ini adalah Terminal-Bench-Science: 52.6% vs 24.7%. AutomationBench naik dari 17.1% ke 31.4%, sementara Terminal-Bench 4.0 meningkat ke 55.8%. Hasilnya merupakan argumen kuat untuk menguji Fable 5.1 pada agen riset, coding jangka panjang, dan otomasi bisnis—bukan untuk merutekan setiap permintaan pendek ke model termahal.

Apa yang Berubah dari Claude Fable 5 API?

Tiga Perubahan yang Merusak Kompatibilitas

Pemaksaan Penggunaan Tool Tidak Lagi Didukung

Claude Fable 5.1 menolak nilai tool_choice yang memaksa tool apa pun atau tool bernama tertentu, mengembalikan error 400 invalid-request. Gunakan pemilihan otomatis, gunakan skema ketat atau structured outputs untuk validasi, dan terapkan langkah alur kerja wajib dalam orkestrasi aplikasi alih-alih memaksa panggilan tool model.

Model Sebelumnya Tidak Dapat Membaca Thinking Blocks Fable 5.1

Kompatibilitas thinking bersifat satu arah: Fable 5.1 dapat mengonsumsi thinking blocks yang dibuat oleh model Claude sebelumnya yang kompatibel, tetapi model sebelumnya tidak dapat membaca blok yang dibuat oleh Fable 5.1. Router atau fallback yang beralih ke model lebih lama dapat menghapus blok tersebut sebelum inferensi, jadi integrasi harus mencatat perpindahan model dan menguji perilaku fallback secara eksplisit.

Mengedit Giliran Sebelumnya Membatalkan Thinking yang Dipertahankan

Mengubah prompt sistem, definisi tool, pesan, atau bytes file yang dirujuk pada giliran sebelumnya dapat membatalkan thinking block selanjutnya. Perlakukan prefiks percakapan sebagai append-only, gunakan instruksi di tengah percakapan alih-alih menulis ulang riwayat, dan pantau transformasi ketidakcocokan prefiks selama migrasi.

Lima Kapabilitas API Tambahan

Effort per Pesan

Aplikasi dapat mengubah effort selama percakapan tanpa membatalkan cache prompt. Kapabilitas beta ini memungkinkan alur kerja menurunkan effort untuk tindak lanjut rutin dan menaikkan effort untuk perencanaan, debugging, atau verifikasi yang sulit.

Pesan Sistem Berskala Giliran

Sebuah pesan sistem beta dapat berlaku untuk satu giliran dan kemudian berhenti dirender setelah pesan pengguna berikutnya sambil tetap tidak berubah dalam riwayat. Ini berguna untuk instruksi sementara dalam loop tool karena menjaga kecocokan cache prompt dan keabsahan thinking block selanjutnya.

Pembaruan Progres yang Dapat Dibaca Antara Panggilan Tool

Dengan opsi progress-display beta, thinking block tertentu dapat membawa pembaruan status singkat yang dapat ditampilkan aplikasi kepada pengguna sementara penalaran privat tetap tersembunyi. Agen run panjang harus memperlakukan pembaruan ini sebagai status operasional, bukan jawaban final.

Harga Cache-Read Lebih Rendah

Cache read berharga $0.25 per juta token, seperempat dari tarif cache-read Fable 5, sementara harga input dan output dasar tetap tidak berubah. Ini dapat secara material menurunkan biaya sesi panjang yang berulang kali menggunakan prefiks cache stabil.

Provenans Konten

Teks yang dihasilkan membawa watermark statistik Anthropic, sementara media yang didukung dan diambil melalui Files API dapat menyertakan C2PA Content Credentials bertanda tangan. Mekanisme provenans ini tidak menambah token prompt atau memerlukan perubahan format permintaan.

Apa yang Anda Butuhkan Sebelum Menggunakan Claude Fable 5.1 API?

• Akun dan kunci API: masuk ke CometAPI dan buat kunci di konsol kunci API. Periksa akses model dan bahwa akun Anda siap untuk penagihan berbasis penggunaan sebelum mengirim panggilan uji.
• Runtime lokal: gunakan terminal dengan curl untuk contoh HTTP pertama. Untuk contoh Python, siapkan Python dan pip dalam lingkungan terisolasi, lalu pasang SDK yang digunakan oleh contoh pilihan Anda.
• Rute yang dipilih: Claude Fable 5.1 API di CometAPI menawarkan format Messages dan Chat Completions. Gunakan base URL dan format permintaan yang cocok; jangan campur payload keduanya.
• Konfigurasi aman: setel COMETAPI_KEY di luar file sumber yang dikomit, gunakan claude-fable-5-1 sebagai ID model, dan pastikan jaringan Anda dapat menjangkau https://api.cometapi.com.
• Uji aman dan pemeriksaan penerimaan: mulai dengan prompt pendek yang non-sensitif. Konfirmasi bahwa respons berisi konten yang dapat digunakan, inspeksi penggunaan dan status penyelesaian, dan periksa persyaratan penanganan data organisasi Anda sebelum mengirim dokumen atau log nyata.

Cara Mengakses Claude Fable 5.1 Melalui CometAPI

CometAPI mengekspos Claude Fable 5.1 melalui rute Messages yang kompatibel dengan Anthropic dan rute Chat Completions yang kompatibel dengan OpenAI. Gunakan Messages saat Anda membutuhkan effort, thinking, caching, dan semantik tool Claude native; gunakan Chat Completions saat aplikasi Anda sudah distandardisasi pada OpenAI SDK.

Langkah 1: Simpan kunci API

export COMETAPI_KEY="your-cometapi-key"

$env:COMETAPI_KEY="your-cometapi-key"

Langkah 2: Buat permintaan Messages pertama

curl https://api.cometapi.com/v1/messages \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-fable-5-1",
    "max_tokens": 2048,
    "messages": [{
      "role": "user",
      "content": "Review this deployment architecture and list the three highest-risk failure modes."
    }]
  }'

Langkah 3: Gunakan Anthropic Python SDK

pip install anthropic

import os
import anthropic

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

response = client.messages.create(
    model="claude-fable-5-1",
    max_tokens=4096,
    messages=[{
        "role": "user",
        "content": "Find the root cause of this test failure and propose a verified patch.",
    }],
)

print(response.content[0].text)

Langkah 4: Gunakan OpenAI Python SDK

pip install openai

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-fable-5-1",
    messages=[{
        "role": "user",
        "content": "Design a migration plan for this service.",
    }],
)

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

Bagaimana cara kerja penalaran untuk Claude Fable 5.1 API?

Model Sebelumnya Tidak Dapat Membaca Thinking Blocks Claude Fable 5.1

Thinking blocks yang dihasilkan Fable 5.1 tidak kompatibel mundur dengan model Claude sebelumnya. Jika alur kerja mengubah model di tengah percakapan, hapus thinking block yang tidak kompatibel atau mulai cabang baru sambil mempertahankan hanya pesan yang terlihat oleh pengguna dan hasil tool yang diperlukan untuk permintaan berikutnya.

Mengedit Giliran Sebelumnya Membatalkan Thinking yang Dipertahankan

Thinking block yang dipertahankan terikat secara kriptografis pada status percakapan sebelumnya. Mengubah prompt sistem, definisi tool, pesan pengguna, respons asisten, atau hasil tool dapat merusak ikatan tersebut dan memicu error riwayat thinking. Jaga prefiks yang diputar ulang tetap stabil byte-per-byte dan tambahkan giliran baru alih-alih menulis ulang yang lama.

Thinking yang Dipertahankan Antar Giliran

Saat prefiks percakapan tetap tidak berubah, thinking yang dipertahankan dapat membawa status penalaran yang berguna ke giliran berikutnya. Simpan thinking block dengan urutan pesan aslinya, putar ulang hanya ke model yang kompatibel, dan perlakukan pengeditan riwayat sebagai cabang percakapan baru daripada memutasi transkrip yang ada.

Kendalikan Penalaran dengan Effort

Mulailah pekerjaan produksi yang sulit pada effort tinggi, lalu uji pengaturan yang lebih rendah pada giliran rutin dan pengaturan yang lebih tinggi hanya ketika kualitas tugas yang diterima meningkat cukup untuk membenarkan latensi dan token tambahan. Karena effort dapat berubah antar giliran, satu percakapan tidak lagi memerlukan level penalaran tunggal sepanjang waktu.

Fable 5.1 menggunakan thinking adaptif sebagai satu-satunya mode thinking. Mulailah pada effort tinggi, lalu ukur pengaturan yang lebih rendah untuk pekerjaan rutin dan xhigh atau max hanya ketika kapabilitas tambahan membenarkan biaya dan latensi.

response = client.messages.create(
    model="claude-fable-5-1",
    max_tokens=8192,
    output_config={"effort": "high"},
    messages=[{
        "role": "user",
        "content": "Audit this repository migration plan.",
    }],
)

Claude Fable 5.1 API: Streaming Respons Panjang, Gunakan Tools, dan Prompt Caching

Konfigurasikan kontrol berikut bersama: effort penalaran, streaming, eksekusi tool, prompt caching, serta penanganan safeguards dan data yang dipertahankan. Masing-masing memengaruhi bagaimana permintaan run panjang diamati, divalidasi, dan dioperasikan.

Streaming Respons Panjang

Streaming adalah default yang lebih aman untuk tugas panjang ber-effort tinggi karena menghindari menunggu respons besar selesai sebelum aplikasi menerima output apa pun.

with client.messages.stream(
    model="claude-fable-5-1",
    max_tokens=8192,
    output_config={"effort": "high"},
    messages=[{
        "role": "user",
        "content": "Analyze these logs and produce a remediation plan.",
    }],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

Gunakan Tools Tanpa Pemaksaan Pemilihan

Fable 5.1 menolak pemilihan tool paksa menggunakan tipe tool_choice any atau tool bernama. Gunakan pemilihan otomatis, skema ketat, validasi argumen tool dalam kode aplikasi, dan kendalikan urutan alur kerja wajib di luar model. Jika alur kerja memerlukan tool tertentu untuk dijalankan, jangan andalkan tool_choice untuk menegakkan urutan. Buat aplikasi memanggil tool itu atau implementasikan langkah yang diperlukan dalam kode orkestrasi.

tools = [{
    "name": "search_incidents",
    "description": "Search recent production incidents",
    "input_schema": {
        "type": "object",
        "properties": {
            "service": {"type": "string"},
            "days": {"type": "integer"},
        },
        "required": ["service", "days"],
    },
}]

response = client.messages.create(
    model="claude-fable-5-1",
    max_tokens=4096,
    tools=tools,
    tool_choice={"type": "auto"},
    messages=[{
        "role": "user",
        "content": "Review checkout incidents from the last 30 days.",
    }],
)

Gunakan Prompt Caching untuk Konteks Panjang

Anthropic mencantumkan cache read pada $0.25 per juta token, seperempat tarif Fable 5. Letakkan instruksi sistem stabil, skema tool, dan materi referensi besar sebelum konten pengguna dinamis, lalu verifikasi cache hit dalam metadata penggunaan.

messages = [{
    "role": "user",
    "content": [
        {
            "type": "text",
            "text": large_reference_document,
            "cache_control": {"type": "ephemeral"},
        },
        {
            "type": "text",
            "text": "Identify obligations that changed in this revision.",
        },
    ],
}]

Tangani Safeguards dan Retensi Data

Anthropic menyatakan bahwa banyak permintaan keamanan siber dan biologi yang ditandai dialihkan ke model yang kurang mampu. Perlakukan penolakan atau fallback sebagai status aplikasi: catat alasan berhenti, tampilkan pesan pengguna yang sesuai, dan rute ke alternatif yang disetujui jika kebijakan memungkinkan.

Fable juga memerlukan retensi data 30 hari secara default untuk pemantauan keamanan. Konfirmasikan kelayakan organisasi dan pengaturan retensi sebelum men-debug permintaan yang valid secara sintaks seolah-olah itu hanya masalah format API.

Fable 5.1 vs Opus 5 vs Sonnet 5

Hasil seleksi: mulai lalu lintas rutin di Sonnet 5, gunakan Opus 5 untuk pekerjaan umum yang kompleks, dan eskalasi hanya tugas tersulit atau yang berulang kali gagal ke Fable 5.1. Ini mengikuti panduan Anthropic dan mencegah penalaran premium menjadi biaya default setiap permintaan.

Harga Melalui CometAPI

Halaman model CometAPI live adalah sumber kebenaran untuk ketersediaan rute dan harga saat ini. Untuk permintaan dengan 100.000 token input tanpa cache dan 10.000 token output, estimasi sederhana CometAPI adalah $1.20; biaya aktual dapat berubah dengan caching, penalaran, perilaku batch, dan routing. Harga dapat berubah; periksa halaman model live sebelum penganggaran produksi.

Daftar Periksa Migrasi dari Fable 5

1. Ubah ID model dari claude-fable-5 ke claude-fable-5-1.
2. Hapus pemaksaan tool_choice any dan tool bernama; gunakan auto.
3. Ganti asumsi anggaran thinking lama dengan output_config.effort.
4. Mulai evaluasi pada effort tinggi, lalu lakukan tuning terhadap tugas nyata.
5. Jaga riwayat append-only saat mengandung thinking block yang dipertahankan.
6. Tingkatkan max_tokens untuk run panjang ber-effort tinggi.
7. Verifikasi cache hit dari metadata penggunaan.
8. Tangani penolakan dan fallback sebagai status eksplisit.
9. Putar ulang jejak produksi dan bandingkan tingkat tugas diterima, latensi, dan biaya.

Strategi migrasi paling aman: jaga riwayat append-only. Fable 5.1 dapat mempertahankan thinking blocks antar giliran, tetapi thinking block yang diputar ulang terikat pada status percakapan sebelumnya; mengubah prompt sistem, tools, atau pesan sebelumnya dapat membatalkan ikatan tersebut.

Error API Umum

Error 400 setelah mengubah panggilan tool

Penyebab kemungkinan: pemaksaan tool_choice menggunakan any atau tool bernama. Gunakan auto dan terapkan urutan yang diperlukan dalam logika aplikasi.

claude-fable-5.1 tidak berfungsi

ID kanonik menggunakan tanda hubung: claude-fable-5-1.

Output berakhir lebih awal dari yang diharapkan

effort mengontrol seberapa banyak penalaran yang dilakukan model, sementara max_tokens membatasi anggaran token respons. Effort lebih tinggi dapat memerlukan anggaran output lebih besar, jadi aplikasi produksi harus men-tune keduanya secara independen. Naikkan max_tokens jika dibenarkan dan stream respons panjang.

Prompt cache tidak pernah hit

Jaga prefiks cache stabil byte-per-byte; timestamp, alat yang diurut ulang, dan perubahan pesan sistem mencegah reuse.

Respons HTTP-berhasil tidak mengandung jawaban normal

Inspeksi stop_reason dan metadata fallback alih-alih memperlakukan setiap penolakan sebagai error transport.

Memutar ulang riwayat menghasilkan error thinking

Jangan edit giliran sebelumnya sebelum thinking block Fable 5.1 yang dipertahankan. Gunakan riwayat append-only atau kontrol migrasi saat ini.

Bagaimana Anda Harus Menggunakan Claude Fable 5.1 API di Produksi?

Pisahkan routing permintaan, eksekusi model, eksekusi tool, validasi, dan evaluasi. Catat ID model, effort, latensi, penggunaan token, penggunaan cache, alasan berhenti, perilaku fallback, dan keberhasilan tugas akhir.

Gunakan Fable 5.1 untuk migrasi seluruh repositori, debugging sulit, agen run panjang, riset mendalam, sintesis dokumen besar, dan tugas bernilai tinggi di mana model lebih murah berulang kali gagal. Hindari sebagai default untuk ringkasan, klasifikasi, ekstraksi, dan respons layanan pelanggan pendek.

Contoh: Investigasi Insiden Checkout

Tim dapat menyediakan error checkout yang disanitasi, diff deployment terbaru, dan runbook relevan. Aplikasi mengambil catatan insiden yang cocok, lalu meminta model untuk memberi peringkat kemungkinan penyebab dan menghubungkan setiap hipotesis ke bukti. Seorang engineer meninjau langkah diagnostik yang diusulkan dan menyetujui pengujian di sandbox menggunakan transaksi sintetis. Gerbang penerimaan adalah perilaku yang dapat direproduksi, bukti yang dapat ditelusuri, dan lulus pemeriksaan regresi; setiap remediasi produksi memerlukan persetujuan manusia terpisah.

Contoh: Analisis Perubahan Persyaratan Operasional

Tim dapat menyediakan manual operasional yang disetujui, kebijakan pendukung, dan draft revisi. Jaga materi referensi yang tidak berubah sebagai konteks stabil, lalu minta model membandingkan kewajiban yang berubah, tim yang bertanggung jawab, tenggat, dan pengecualian. Setiap temuan yang diusulkan harus merujuk pada bagian relevan di kedua versi dan membedakan perubahan eksplisit dari interpretasi yang tidak pasti. Gerbang penerimaan adalah peninjau mengonfirmasi setiap perubahan yang dilaporkan terhadap bukti yang dikutip sebelum memperbarui prosedur atau memberi tahu tim yang terdampak.

Kesimpulan

Claude Fable 5.1 bukan pembaruan string model yang plug-and-play. Perilaku pemaksaan tool, aturan riwayat thinking, kontrol effort, ekonomi cache, dan fitur progres run panjangnya memerlukan migrasi yang disengaja.

Deployment paling efektif menggunakan Claude Sonnet 5 untuk volume rutin, Claude Opus 5 untuk lalu lintas default yang kompleks, dan Claude Fable 5.1 sebagai eskalasi kapabilitas terukur. Promosikan hanya ketika tingkat penyelesaian tugas yang diterima meningkat cukup untuk membenarkan total biaya dan latensi.