Seri Teks
Claude Messages API
- Sepenuhnya kompatibel dengan format Claude Messages API
- Mendukung percakapan multi-giliran dan kueri tunggal
- Mendukung konten multimodal, termasuk teks dan gambar
POST
Documentation Index
Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
Use this file to discover all available pages before exploring further.
Otorisasi
API key untuk autentikasiKunjungi Halaman Manajemen API Key untuk mendapatkan API Key AndaTambahkan ke header request:
Versi APISpecifies the Claude Versi API to useContoh:
2025-10-01Body
Nama model
claude-haiku-4-5-20251001- Claude 4.5 versi respons cepatclaude-sonnet-4-5-20250929- Claude 4.5 versi seimbangclaude-opus-4-1-20250805- Model unggulan Claude 4.1 paling mampuclaude-opus-4-1-20250805-thinking- Claude 4.1 Opus versi penalaran mendalamclaude-sonnet-4-5-20250929-thinking- Claude 4.5 Sonnet versi penalaran mendalam
Daftar pesanArray pesan yang digunakan model untuk menghasilkan respons berikutnya. Setiap pesan berisi field Percakapan multi-giliran:Respons assistant yang sudah diisi sebelumnya:
role dan content.💡 Pengisian cepat (area Try it):- Klik ”+ Add an item” untuk menambahkan pesan
- Input
role:user(pesan pengguna) atauassistant(respons AI, untuk multi-giliran) - Input
content: teks pesan Anda
Token maksimum yang akan dibuatJumlah maksimum token yang akan dibuat sebelum berhenti. Model dapat berhenti sebelum mencapai batas ini.Setiap model memiliki nilai maksimum yang berbeda. Minimum: 1
Prompt sistemPrompt sistems set Claude’s role, personality, goals, and instructions.Format string:Format terstruktur:
Parameter temperature, rentang 0-1Mengontrol keacakan output:
- Nilai rendah (misalnya 0,2): lebih deterministik dan konservatif
- Nilai tinggi (misalnya 0,8): lebih acak dan kreatif
Parameter nucleus sampling, rentang 0-1Menggunakan nucleus sampling. Sebaiknya gunakan salah satu dari
temperature atau top_p, bukan keduanya.Default: 1.0Sampling Top-KHanya sampling dari K opsi teratas, sehingga menghapus respons probabilitas rendah di “long tail”.Disarankan hanya untuk kasus penggunaan lanjutan.
Aktifkan streamingJika
true, menggunakan Server-Sent Events (SSE) untuk mengalirkan respons.Default: falseUrutan penghentiUrutan teks khusus yang membuat model berhenti menghasilkan output.Maksimum 4 urutan.Contoh:
["\n\nHuman:", "\n\nAssistant:"]MetadataObjek metadata untuk request.Mencakup:
user_id: Pengidentifikasi pengguna
Definisi toolDaftar tool yang dapat digunakan model untuk menyelesaikan tugas.Contoh function tool:Jenis tool yang didukung:
- Tool fungsi kustom
- Tool penggunaan komputer (computer_20241022)
- Tool editor teks (text_editor_20241022)
- Tool Bash (bash_20241022)
Strategi pemilihan toolMengontrol cara model menggunakan tool:
{"type": "auto"}: Menentukan otomatis (default){"type": "any"}: Harus menggunakan tool{"type": "tool", "name": "tool_name"}: Gunakan tool tertentu
Respons
Pengidentifikasi pesan unikContoh:
"msg_013Zva2CMHLNnXjNJJKqJ2EF"Jenis objekSelalu
"message"RoleSelalu
"assistant"Array blok kontenKonten yang dihasilkan model, dalam bentuk array blok konten.Konten teks:Penggunaan tool:Jenis konten:
text: Konten tekstool_use: Pemanggilan tool
Model yang menangani requestContoh:
"claude-sonnet-4-5-20250929"Alasan berhentiNilai yang mungkin:
end_turn: Selesai secara alamimax_tokens: Mencapai token maksimumstop_sequence: Mengenai urutan penghentitool_use: Memanggil tool
Urutan penghenti yang terpicuUrutan penghenti yang dihasilkan, jika ada; jika tidak, bernilai
nullStatistik penggunaan token
Contoh Penggunaan
Percakapan Dasar
Percakapan Multi-Giliran
Menggunakan Prompt Sistem
Respons Streaming
Penggunaan Tool
Pemahaman Vision
Gambar Base64
Praktik Terbaik
1. Rekayasa Prompt
Definisi role yang jelas:2. Penanganan Error
3. Optimasi Token
4. Pengisian Awal Respons
Penanganan Respons Streaming
Streaming Python
Streaming JavaScript
Catatan Penting
-
Keamanan API Key:
- Simpan API key dalam variabel lingkungan
- Jangan pernah menulis key secara hardcode di kode sumber
- Rotasi key secara berkala
-
Rate Limiting:
- Perhatikan batas rate API
- Terapkan mekanisme retry
- Gunakan backoff eksponensial
-
Manajemen Token:
- Pantau penggunaan token
- Optimalkan panjang prompt
- Gunakan nilai
max_tokensyang sesuai
-
Pemilihan Model:
- Opus: tugas kompleks yang membutuhkan penalaran mendalam
- Sonnet: performa dan biaya yang seimbang
- Haiku: respons cepat untuk tugas sederhana
-
Penyaringan Konten:
- Validasi input pengguna
- Saring informasi sensitif
- Terapkan moderasi konten