Cara Integrasikan Claude API ke dalam Apl Anda
Untuk mengintegrasikan Claude API, cipta kunci API dalam Claude Console Anthropic, simpan sebagai rahsia di pelayan (biasanya ANTHROPIC_API_KEY), dan panggil Messages API daripada laluan di pelayan anda sendiri menggunakan salah satu SDK rasmi Anthropic. Setiap permintaan menamakan model, menetapkan max_tokens (balasan terpanjang yang anda terima) dan menghantar perbualan sebagai messages, dengan arahan anda dalam system prompt yang berasingan. Tetapkan had perbelanjaan, strim balasan yang panjang, dan uruskan ralat had kadar (429) dan beban berlebihan (529) dengan cubaan semula.
Panduan ini meliputi persediaan, aliran permintaan yang selamat, prompt untuk pembina AI, dan ralat yang perlu dirancang. Butiran Anthropic adalah daripada dokumentasinya setakat September 2026. Untuk cara token dan harga berfungsi secara umum, baca cara guna LLM API dahulu.
Apa yang boleh anda bina dengannya
- Pembantu sembang dan widget bantuan (cara bina aplikasi chatbot AI)
- Ringkasan, penulisan semula dan balasan yang dikarang
- Mengekstrak medan daripada dokumen, e-mel dan borang
- Menjawab soalan daripada kandungan anda sendiri
- Ejen yang memanggil fungsi apl anda melalui penggunaan alat (tool use)
Untuk lebih banyak idea, lihat cara tambah ciri AI ke dalam apl anda.
Messages API secara ringkas
Menurut rujukan API Anthropic, permintaan ialah POST ke https://api.anthropic.com/v1/messages dengan:
| Bahagian | Maksud |
|---|---|
x-api-key header | Kunci API anda |
anthropic-version header | Versi API, contohnya 2023-06-01 |
model (wajib) | Model Claude yang hendak digunakan |
max_tokens (wajib) | Bilangan token paling banyak dalam balasan; model mungkin berhenti lebih awal |
messages (wajib) | Perbualan: giliran user dan assistant yang bergilir |
system (pilihan) | Arahan yang terpakai untuk keseluruhan perbualan |
stream (pilihan) | Tetapkan kepada true untuk menerima balasan semasa ia ditulis, melalui server-sent events |
API ini tidak menyimpan keadaan: untuk meneruskan perbualan, hantar semula giliran sebelumnya bersama setiap permintaan. Itulah sebabnya sembang yang panjang menelan kos lebih untuk setiap mesej.
Anthropic menerbitkan SDK rasmi untuk Python, TypeScript, C#, Go, Java, PHP dan Ruby. Ia menetapkan pengepala, menghurai respons, dan menyokong streaming. Gunakannya dan bukan HTTP mentah melainkan ada sebab khusus.
Memilih model
Anthropic menawarkan beberapa model Claude yang menukar keupayaan dengan kelajuan dan harga, dan senarai itu berubah. Pilih model terkecil yang melaksanakan tugas anda dengan baik, uji dengan contoh sebenar, dan simpan ID model dalam konfigurasi supaya anda boleh menukarnya tanpa menukar kod. Semak halaman model dan harga Anthropic untuk pilihan dan kadar semasa.
Menyediakan akaun anda
- Log masuk ke Claude Console di platform.claude.com dan tambah pengebilan.
- Cipta kunci API. Simpan satu kunci untuk setiap persekitaran (ujian dan pengeluaran) supaya anda boleh membatalkan satu tanpa memecahkan yang lain.
- Tetapkan had perbelanjaan. Halaman ralat Anthropic menyatakan bahawa apabila penggunaan mencapai had perbelanjaan yang anda tetapkan, API mengembalikan ralat 400, jadi apl anda patut memaparkan mesej yang jelas apabila itu berlaku.
- Semak had kadar untuk akaun anda dalam Console; ia diukur mengikut organisasi.
Aliran permintaan
- Pengguna bertindak dalam apl anda: menghantar mesej, mengklik "Ringkaskan".
- Pelayar memanggil laluan pelayan anda, bukan Anthropic secara terus.
- Pelayan anda menyemak pengguna telah log masuk dan dibenarkan menggunakan ciri itu, serta menggunakan had setiap pengguna.
- Ia membina permintaan: system prompt dengan peraturan anda, input pengguna, dan sebarang data daripada pangkalan data yang diperlukan tugas.
- Ia memanggil Messages API dengan kunci daripada persekitaran dan
max_tokensyang munasabah. - Ia menstrim balasan ke pelayar dan merekod penggunaan token daripada respons.
Pilihan dan pertukaran
| Keputusan | Pilihan mudah | Bila perlu lebih jauh |
|---|---|---|
| Streaming | Tunggu balasan penuh | Strim untuk sembang dan apa sahaja yang panjang; Anthropic mengesyorkan streaming atau batch untuk permintaan yang lama |
| Format output | Teks biasa | Output JSON berstruktur apabila kod anda perlu membaca medan |
| Data anda | Sertakan rekod yang berkaitan | Pengambilan maklumat ke atas kandungan anda apabila terlalu banyak (apa itu RAG) |
| Tindakan | Model hanya menulis teks | Penggunaan alat, di mana model meminta kod anda menjalankan fungsi yang anda takrifkan |
| Kerja pukal yang tidak mendesak | Gelung pada setiap item | Message Batches API, yang anda hantar dan semak untuk keputusan |
Prompt untuk pembina AI anda
Ciri pertama:
Tambah panel "Tanya tentang dokumen ini". Ia memanggil laluan pelayan POST /api/ask yang menyemak pengguna telah log masuk dan memiliki dokumen itu, kemudian memanggil Claude Messages API dengan SDK Anthropic rasmi dan rahsia ANTHROPIC_API_KEY. Baca ID model daripada rahsia CLAUDE_MODEL. System prompt: "Jawab hanya daripada dokumen yang diberikan. Jika jawapan tiada dalam dokumen, katakan begitu." Hantar teks dokumen dan soalan, tetapkan max_tokens kepada 800, strim jawapan ke halaman, dan jangan sekali-kali dedahkan kunci kepada pelayar.
Pengawal dan ralat:
Hadkan setiap pengguna kepada 20 soalan sejam, dijejaki dalam pangkalan data. Rekod token input dan output daripada setiap respons bersama ID pengguna dan ID permintaan. Pada ralat 429 atau 529, cuba semula dengan backoff eksponen sehingga 3 kali, hormati pengepala retry-after jika ada, kemudian papar "Pembantu sedang sibuk, cuba lagi sebentar." Jika API melaporkan ralat had perbelanjaan, papar "Ciri AI dijeda" dan beri amaran kepada pentadbir.
Ralat yang perlu dirancang
Daripada dokumentasi ralat Anthropic, ini ralat yang sebenarnya akan dihadapi oleh apl anda:
| Kod | Jenis | Apa yang perlu dibuat |
|---|---|---|
| 400 | invalid_request_error | Betulkan permintaan; ia juga dikembalikan apabila anda mencapai had perbelanjaan yang anda tetapkan |
| 401 | authentication_error | Semak kunci wujud, betul dan tidak dibatalkan |
| 413 | request_too_large | Hantar kurang; Messages API menerima sehingga 32 MB setiap permintaan |
| 429 | rate_limit_error | Undur dan cuba semula, hormati retry-after |
| 500 | api_error | Cuba semula dengan backoff; hubungi sokongan dengan ID permintaan jika ia berterusan |
| 529 | overloaded_error | Trafik tinggi sementara daripada semua pengguna; undur dan cuba semula |
Dokumentasi Anthropic menyatakan bahawa SDK rasmi secara automatik mencuba semula kegagalan sementara (ralat sambungan, had kadar dan ralat 5xx) dua kali secara lalai dengan backoff eksponen, dan anda boleh mengkonfigurasinya. Setiap respons membawa pengepala request-id; rekodkannya supaya sokongan dapat menjejaki masalah.
Kesilapan biasa
- Memanggil API dari pelayar. Kunci anda menjadi awam. Sentiasa lalui pelayan anda. Lihat cara pastikan kunci API selamat.
- Lupa bahawa
max_tokensialah had, bukan sasaran. Tetapkan mengikut keperluan ciri; terlalu rendah memotong jawapan, terlalu tinggi berisiko balasan yang panjang dan mahal. - Meletakkan peraturan dalam mesej pengguna. Arahan yang stabil patut berada dalam
systemprompt; kebenaran patut berada dalam kod anda. - Menghantar keseluruhan sembang selama-lamanya. Potong atau ringkaskan giliran lama apabila perbualan bertambah.
- Tiada had perbelanjaan atau had setiap pengguna.
- Mengkodkan ID model secara keras. Model dikemas kini dan ditamatkan.
- Mengabaikan sebab berhenti. Jika balasan berhenti kerana mencapai
max_tokens, beritahu pengguna atau naikkan had.
Senarai semak
- Kunci API dicipta dalam Claude Console dan disimpan sebagai rahsia di pelayan
- Kunci berasingan untuk ujian dan pengeluaran
- Had perbelanjaan ditetapkan; mesej jelas apabila dicapai
- Semua permintaan melalui pelayan anda dengan semakan kebenaran
- System prompt memegang peraturan; ID model boleh dikonfigurasi
-
max_tokensditetapkan bagi setiap ciri; balasan panjang distrim - Had kadar setiap pengguna dalam apl anda
- 429 dan 529 dikendalikan dengan backoff; ID permintaan direkod
- Keadaan ralat yang mesra pengguna dan tidak memecahkan halaman
- Diuji dengan input kosong, sangat panjang dan bermusuhan
Menggunakan Claude API dalam Mythex
Dalam apl yang anda bina di Mythex, ciri Claude menggunakan kunci Anthropic anda sendiri dan dibilkan ke akaun Anthropic anda, bukan kepada kredit binaan Mythex. Itu berasingan daripada ejen Mythex yang menulis kod anda. Tambah ANTHROPIC_API_KEY sebagai rahsia projek melalui /secrets, tetapan projek atau kad rahsia dalam sembang, kemudian terangkan ciri itu menggunakan prompt seperti di atas. Terbitkan semula selepas menukar rahsia pada apl yang sedang aktif. Lihat Tambah ciri AI dengan kunci API anda sendiri untuk prompt permulaan. Jika anda memilih antara pembekal, cara integrasi OpenAI API meliputi perkara yang sama untuk OpenAI.
Soalan lazim
Bagaimana saya dapatkan kunci API Claude?
Log masuk ke Claude Console di platform.claude.com, sediakan pengebilan, dan cipta kunci API. Simpan sebagai rahsia di pelayan, biasanya dinamakan ANTHROPIC_API_KEY, dan jangan sekali-kali letakkannya dalam kod pelayar.
Apakah yang diperlukan untuk permintaan ke Claude API?
Pada September 2026, rujukan Messages API Anthropic menyenaraikan tiga medan badan yang diperlukan: model, max_tokens dan messages. Panggilan HTTP terus juga memerlukan pengepala x-api-key dan anthropic-version; SDK rasmi menetapkannya untuk anda.
Apakah ralat 529 daripada Claude API?
Halaman ralat Anthropic menerangkan 529 sebagai overloaded_error: API sementara sesak kerana trafik tinggi daripada semua pengguna. Cuba semula dengan backoff eksponen. SDK rasmi mencuba semula sebahagian ralat sementara secara automatik.
Bolehkah saya guna Claude dengan kod yang ditulis untuk OpenAI SDK?
Anthropic mendokumentasikan lapisan keserasian OpenAI SDK untuk menggunakan Claude melalui permukaan OpenAI SDK. Untuk kod baharu, SDK sendiri memberi akses kepada ciri khusus Claude, jadi ia biasanya titik permulaan yang lebih baik.