Claude Platform Docs
Referensi APIMenggunakan API

Header beta

Akses fitur eksperimental sebelum menjadi bagian dari API standar dengan header anthropic-beta atau parameter betas pada SDK.

"Beta headers" (header beta) memungkinkan Anda mengakses fitur eksperimental dan kemampuan model baru sebelum menjadi bagian dari API standar.

Cara menggunakan header beta

Untuk mengakses fitur beta, sertakan header anthropic-beta dalam permintaan API Anda:

POST /v1/messages
x-api-key: YOUR_API_KEY
anthropic-version: 2023-06-01
anthropic-beta: BETA_FEATURE_NAME
content-type: application/json

Dokumentasi setiap fitur menyebutkan nama beta persis yang harus dikirim. Ikhtisar API mencantumkan API yang saat ini dalam tahap beta.

Contoh berikut menunjukkan permintaan yang sama dengan cURL, CLI ant, dan SDK, menggunakan beta context editing (pengeditan konteks) sebagai contoh. SDK menerima nama beta dalam parameter betas dan mengirimkan header anthropic-beta untuk Anda:

client = Anthropic()

response = client.beta.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
    betas=["context-management-2025-06-27"],
)

print(response.content)

Beberapa fitur beta

Untuk menggunakan beberapa fitur beta dalam satu permintaan, sertakan semua nama fitur dalam header yang dipisahkan dengan koma:

anthropic-beta: feature1,feature2,feature3

Anda juga dapat mengirim header anthropic-beta lebih dari sekali dalam permintaan yang sama. Claude API membaca setiap header anthropic-beta, sehingga contoh berikut setara dengan contoh sebelumnya:

anthropic-beta: feature1
anthropic-beta: feature2
anthropic-beta: feature3

Saat menggunakan SDK, cantumkan setiap fitur dalam parameter betas (misalnya, betas=["feature1", "feature2"]). Dengan CLI, berikan satu flag --beta dengan nama-nama fitur yang dipisahkan koma (misalnya, --beta feature1,feature2). Anda juga dapat mengulangi flag tersebut (misalnya, --beta feature1 --beta feature2).

Header khusus endpoint

Beberapa API beta dibatasi pada endpoint tertentu dan memerlukan header beta khusus fitur pada setiap permintaan:

EndpointHeader beta
/v1/agents, /v1/sessions, /v1/environmentsmanaged-agents-2026-04-01
/v1/tunnelsmcp-tunnels-2026-06-22
/v1/memory_stores dan sub-resource-nyaagent-memory-2026-07-22

Namespace beta pada SDK menambahkan header ini secara otomatis. Tambahkan sendiri hanya saat membuat permintaan HTTP mentah. Lihat ikhtisar Managed Agents, Menggunakan memori agen, dan referensi MCP tunnels untuk detailnya.

Header khusus endpoint yang berlaku untuk endpoint yang sama tidak selalu dapat digabungkan. Pada endpoint memory store, agent-memory-2026-07-22 menggantikan managed-agents-2026-04-01: mengirim keduanya pada permintaan yang sama akan mengembalikan error 400. SDK klien mengirimkan header yang benar untuk setiap endpoint secara otomatis.

Konvensi penamaan versi

Nama fitur beta biasanya mengikuti pola feature-name-YYYY-MM-DD, di mana tanggal menunjukkan kapan beta tersebut dirilis. Selalu gunakan nama fitur beta yang persis seperti yang didokumentasikan.

Penanganan error

Jika Anda menggunakan nama beta yang tidak valid, atau beta yang tidak dapat diakses oleh organisasi Anda, Anda akan menerima respons error 400:

Output
{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "Unexpected value(s) `invalid-beta-name` for the `anthropic-beta` header. Please consult our documentation at platform.claude.com/docs or try again without the header."
  },
  "request_id": "req_011CcnGfC9fELffo2EALu4Wd"
}

Mendapatkan bantuan

Untuk pembaruan fitur beta, lihat catatan rilis. Untuk bantuan terkait masalah produksi, hubungi dukungan.

Langkah selanjutnya

Error

Pahami kode status HTTP, bentuk respons error, dan ID permintaan yang dikembalikan Claude API, serta tangani error dengan exception bertipe pada SDK.

Ikhtisar API

Jelajahi fitur-fitur Claude API, termasuk API yang saat ini dalam tahap beta.

Was this page helpful?