Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Permintaan dan Tanggapan
Badan permintaan diteruskan di `body` bidang permintaan ke [InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html)atau [InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html).
**catatan**
Pembatasan berlaku untuk operasi berikut:`InvokeModel`,`InvokeModelWithResponseStream`,`Converse`, dan`ConverseStream`. Lihat [pembatasan API](inference-api-restrictions.md) untuk detailnya.
**Awas**
Claude Sonnet 4.5dan Claude Haiku 4.5 dukungan menentukan `top_p` parameter `temperature` atau, tetapi tidak keduanya. Ini tidak berlaku untuk model lama.
------
#### [ Request ]
AnthropicClaudememiliki parameter inferensi berikut untuk panggilan inferensi pesan.
```
{
"anthropic_version": "bedrock-2023-05-31",
"anthropic_beta": ["computer-use-2024-10-22"]
"max_tokens": int,
"system": string | [{"type": "text", "text": string}],
"messages": [
{
"role": string,
"content": [
{ "type": "image", "source": { "type": "base64", "media_type": "image/jpeg", "data": "{{content image bytes}}" } },
{ "type": "text", "text": "{{content text}}" }
]
}
],
"temperature": float,
"top_p": float,
"top_k": int,
"tools": [
{
"type": "custom",
"name": string,
"description": string,
"input_schema": json
},
{
"type": "computer_20241022",
"name": "computer",
"display_height_px": int,
"display_width_px": int,
"display_number": 0 int
},
{
"type": "bash_20241022",
"name": "bash"
},
{
"type": "text_editor_20241022",
"name": "str_replace_editor"
}
],
"tool_choice": {
"type" : string,
"name" : string,
},
"stop_sequences": [string]
}
```
Berikut ini adalah parameter yang diperlukan.
+ **anthropic\_version** — (Wajib) Versi antropik. Nilainya harus`bedrock-2023-05-31`.
+ **max\_tokens** — (Wajib) Jumlah maksimum token yang akan dihasilkan sebelum berhenti.
Perhatikan bahwa Anthropic Claude model mungkin berhenti menghasilkan token sebelum mencapai nilai`max_tokens`. AnthropicClaudeModel yang berbeda memiliki nilai maksimum yang berbeda untuk parameter ini. Untuk informasi lebih lanjut, lihat [Perbandingan model](https://docs.anthropic.com/claude/docs/models-overview#model-comparison).
+ **pesan** — (Wajib) Pesan masukan.
+ **peran** — Peran percakapan berubah. Nilai yang valid adalah `user` dan `assistant`.
[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
+ **konten** — (wajib) Isi percakapan berubah, sebagai array objek. Setiap objek berisi bidang **tipe**, di mana Anda dapat menentukan salah satu nilai berikut:
+ `text`— Jika Anda menentukan jenis ini, Anda harus menyertakan bidang **teks** dan menentukan prompt teks sebagai nilainya. Jika objek lain dalam array adalah gambar, prompt teks ini berlaku untuk gambar.
+ `image`— Jika Anda menentukan jenis ini, Anda harus menyertakan bidang **sumber** yang memetakan ke objek dengan bidang berikut:
+ **type** — (required) Jenis pengkodean untuk gambar. Anda dapat menentukan`base64`.
+ **media\_type** — (wajib) Jenis gambar. Anda dapat menentukan format gambar berikut.
+ `image/jpeg`
+ `image/png`
+ `image/webp`
+ `image/gif`
+ **data** - (wajib) Byte gambar yang dikodekan base64 untuk gambar. Ukuran gambar maksimum adalah 3.75MB. Tinggi dan lebar maksimum gambar adalah 8000 piksel.
Berikut ini adalah parameter opsional.
+ **sistem** — (Opsional) Prompt sistem untuk permintaan. Anda dapat memberikan prompt sistem sebagai string atau sebagai array blok konten (misalnya,`[{"type": "text", "text": "your prompt"}]`).
Prompt sistem adalah cara untuk memberikan konteks dan instruksi AnthropicClaude, seperti menentukan tujuan atau peran tertentu. Untuk informasi selengkapnya, lihat [Permintaan sistem](https://docs.anthropic.com/en/docs/system-prompts) dalam Anthropic dokumentasi.
**catatan**
Anda dapat menggunakan prompt sistem dengan Anthropic Claude versi 2.1 atau lebih tinggi.
+ **anthropic\_beta** — (Opsional) Parameter beta antropik adalah daftar string header beta yang digunakan untuk menunjukkan keikutsertaan ke serangkaian fitur beta tertentu.
**catatan**
Varian panjang konteks 1 juta token Claude Sonnet 4 tersedia untuk Anda di AWS Wilayah tertentu sebagai “Layanan Beta” sebagaimana didefinisikan dalam Ketentuan AWS Layanan. Ini tunduk pada Perjanjian Anda dengan AWS dan Ketentuan AWS Layanan, dan model EULA yang berlaku. Silakan lihat halaman [Harga Amazon Bedrock](https://aws.amazon.com/bedrock/pricing/) untuk informasi lebih lanjut tentang harga untuk permintaan konteks yang lebih panjang. Untuk permintaan yang melebihi 200K token input, tingkat konteks panjang berlaku untuk seluruh permintaan, bukan hanya token di atas ambang batas. Kuota layanan terpisah berlaku (untuk informasi selengkapnya, lihat **Service** Quotas di Konsol Manajemen AWS).
Header beta yang tersedia meliputi:
[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
+ **stop\_sequences** — (Opsional) Urutan teks khusus yang menyebabkan model berhenti menghasilkan. AnthropicClaudemodel biasanya berhenti ketika mereka secara alami menyelesaikan giliran mereka, dalam hal ini nilai bidang `stop_reason` respons adalah`end_turn`. Jika Anda ingin model berhenti menghasilkan ketika menemukan string teks khusus, Anda dapat menggunakan parameter. `stop_sequences` Jika model menemukan salah satu string teks kustom, nilai bidang `stop_reason` respons adalah `stop_sequence` dan nilai `stop_sequence` berisi urutan berhenti yang cocok.
Jumlah entri maksimum adalah 8191.
+ **suhu** — (Opsional) Jumlah keacakan yang disuntikkan ke dalam respons.
[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
+ **top\_p** — (Opsional) Gunakan pengambilan sampel nukleus.
Dalam pengambilan sampel nukleus, Anthropic Claude menghitung distribusi kumulatif atas semua opsi untuk setiap token berikutnya dalam urutan probabilitas yang menurun dan memotongnya setelah mencapai probabilitas tertentu yang ditentukan oleh. `top_p` Saat menyesuaikan parameter pengambilan sampel, ubah salah satu `temperature` atau`top_p`. Jangan memodifikasi keduanya secara bersamaan.
[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
+ **top\_k** — (Opsional) Hanya sampel dari opsi K teratas untuk setiap token berikutnya.
Gunakan `top_k` untuk menghapus respons probabilitas rendah ekor panjang.
[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
+ **alat** — (Opsional) Definisi alat yang dapat digunakan model.
**catatan**
Membutuhkan model Anthropic Claude 3.
Jika Anda menyertakan `tools` dalam permintaan Anda, model dapat mengembalikan blok `tool_use` konten yang mewakili penggunaan alat tersebut oleh model. Anda kemudian dapat menjalankan alat-alat tersebut menggunakan input alat yang dihasilkan oleh model dan kemudian secara opsional mengembalikan hasil kembali ke model menggunakan blok `tool_result` konten.
Anda dapat melewati jenis alat berikut:
**Khusus**
Definisi untuk alat khusus.
+ **Jenis** (opsional) — Jenis alat. Jika didefinisikan, gunakan nilainya`custom`.
+ **nama** — Nama alat.
+ **deskripsi** — (opsional, tetapi sangat disarankan) Deskripsi alat.
+ **input\_schema** - Skema JSON untuk alat ini.
**Komputer**
Definisi untuk alat komputer yang Anda gunakan dengan API penggunaan komputer.
+ **type** — Nilai harus`computer_20241022`.
+ **Nama** — Nilai harus`computer`.
+ (Wajib) **display\_height\_px** — Ketinggian tampilan yang dikontrol oleh model, dalam piksel..
[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
+ (Wajib) **display\_width\_px** — Lebar tampilan yang dikendalikan oleh model, dalam piksel.
[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
+ (Opsional) **display\_number — Nomor** tampilan untuk mengontrol (hanya relevan untuk lingkungan X11). Jika ditentukan, alat akan diberikan nomor tampilan dalam definisi alat.
[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html)
**bash**
Definisi untuk alat bash yang Anda gunakan dengan API penggunaan komputer.
+ **Jenis** (opsional) — Nilai harus`bash_20241022`.
+ **nama** — Nilainya harus`bash`. alat.
**editor teks**
Definisi untuk alat editor teks yang Anda gunakan dengan komputer menggunakan API.
+ **Jenis** (opsional) — Nilai harus`text_editor_20241022`.
+ **nama** — Nilainya harus`str_replace_editor`. alat.
+ **tool\_choice** — (Opsional) Mengkhususkan bagaimana model harus menggunakan alat yang disediakan. Model dapat menggunakan alat tertentu, alat apa pun yang tersedia, atau memutuskan dengan sendirinya.
**catatan**
Membutuhkan model Anthropic Claude 3.
+ **Jenis** — Jenis pilihan alat. Nilai yang mungkin adalah `any` (gunakan alat apa pun yang tersedia), `auto` (model memutuskan), dan `tool` (gunakan alat yang ditentukan).
+ **nama** — (Opsional) Nama alat yang akan digunakan. Diperlukan jika Anda menentukan `tool` di `type` bidang.
------
#### [ Response ]
AnthropicClaudeModel mengembalikan bidang berikut untuk panggilan inferensi pesan.
```
{
"id": string,
"model": string,
"type" : "message",
"role" : "assistant",
"content": [
{
"type": string,
"text": string,
"image" :json,
"id": string,
"name":string,
"input": json
}
],
"stop_reason": string,
"stop_sequence": string,
"usage": {
"input_tokens": integer,
"output_tokens": integer
}
}
```
Contoh tanggapan dengan nilai stop\_reason baru:
```
// Example with refusal
{
"stop_reason": "refusal",
"content": [
{
"type": "text",
"text": "I can't help with that request."
}
]
}
// Example with tool_use
{
"stop_reason": "tool_use",
"content": [
{
"type": "tool_use",
"id": "toolu_123",
"name": "calculator",
"input": {"expression": "2+2"}
}
]
}
// Example with model_context_window_exceeded (Claude Sonnet 4.5)
{
"stop_reason": "model_context_window_exceeded",
"content": [
{
"type": "text",
"text": "The response was truncated due to context window limits..."
}
]
}
```
+ **id** — Pengidentifikasi unik untuk respons. Format dan panjang ID mungkin berubah seiring waktu.
+ **model** — ID untuk Anthropic Claude model yang membuat permintaan.
+ **stop\_reason** — Alasan mengapa Anthropic Claude berhenti menghasilkan respons.
+ **end\_turn** — Model mencapai titik berhenti alami
+ **max\_tokens** — Teks yang dihasilkan melebihi nilai bidang `max_tokens` input atau melebihi jumlah maksimum token yang didukung model. '.
+ **stop\_sequence** - Model menghasilkan salah satu urutan berhenti yang Anda tentukan di bidang input. `stop_sequences`
+ **penolakan** — Claude menolak untuk menghasilkan respons karena masalah keamanan
+ **tool\_use** — Claude memanggil alat dan mengharapkan Anda untuk menjalankannya
+ **model\_context\_window\_exceeded** — model menghentikan pembuatan karena mencapai batas jendela konteks.
+ Baru dengan Claude Sonnet 4.5
+ **stop\_sequence — Urutan** berhenti yang mengakhiri generasi.
+ **Jenis** — Jenis respon. Nilainya selalu `message`.
+ **peran** — Peran percakapan dari pesan yang dihasilkan. Nilainya selalu `assistant`.
+ **konten** — Konten yang dihasilkan oleh model. Dikembalikan sebagai array. *Ada tiga jenis konten, *teks*, *tool\_use dan gambar*.*
+ *teks* — Sebuah respon teks.
+ **type** — Jenis konten. Nilai ini adalah `text`.
+ **teks** — Jika nilai `type` adalah teks, berisi teks konten.
+ *penggunaan alat* — Permintaan dari model untuk menggunakan alat.
+ **type** — Jenis konten. Nilai ini adalah `tool_use`.
+ **id** — ID untuk alat yang diminta oleh model.
+ **name** - Berisi nama alat yang diminta.
+ **input** — Parameter input untuk diteruskan ke alat.
+ *Gambar* — Permintaan dari model untuk menggunakan alat.
+ **type** — Jenis konten. Nilai ini adalah `image`.
+ **sumber** - Berisi gambar. Untuk informasi selengkapnya, lihat [Permintaan multimodal](model-parameters-anthropic-claude-messages.md#model-parameters-anthropic-claude-messages-multimodal-prompts).
+ **penggunaan** — Penampung untuk jumlah token yang Anda berikan dalam permintaan dan token nomor dari model yang dihasilkan dalam respons.
+ **input\_tokens** — Jumlah token masukan dalam permintaan.
+ **output\_tokens** — Jumlah token dari model yang dihasilkan dalam respons.
+ **stop\_sequence** - Model menghasilkan salah satu urutan berhenti yang Anda tentukan di bidang input. `stop_sequences`
------
## Parameter upaya (beta)
`effort`Parameter ini merupakan alternatif untuk memikirkan anggaran token untuk Claude Opus 4.5. Parameter ini memberi tahu Claude seberapa bebas ia harus menghabiskan token untuk menghasilkan hasil terbaik, menyesuaikan penggunaan token di seluruh pemikiran, panggilan alat, dan komunikasi pengguna. Ini dapat digunakan dengan atau tanpa mode berpikir yang diperluas.
Parameter upaya dapat diatur ke:
+ `high`(default) — Claude menghabiskan token sebanyak yang diperlukan untuk hasil terbaik
+ `medium`— Penggunaan token seimbang
+ `low`— Penggunaan token konservatif
Untuk menggunakan fitur ini, Anda harus melewati header beta`effort-2025-11-24`.
Contoh permintaan:
```
{
"anthropic_version": "bedrock-2023-05-31",
"anthropic_beta": [
"effort-2025-11-24"
],
"max_tokens": 4096,
"output_config": {
"effort": "medium"
},
"messages": [{
"role": "user",
"content": "Analyze this complex dataset and provide insights"
}]
}
```