Header beta

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 yang tepat untuk dikirim. Ikhtisar API mencantumkan API yang saat ini dalam tahap beta.

Contoh berikut menunjukkan permintaan yang sama dengan cURL, CLI ant, dan SDK. 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",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
    betas=["files-api-2025-04-14"],
)

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

Saat menggunakan SDK, cantumkan setiap fitur dalam parameter betas (misalnya, betas=["feature1", "feature2"]). Dengan CLI, berikan satu flag --beta dengan nama fitur yang dipisahkan dengan koma (misalnya, --beta feature1,feature2). Hindari mengulang flag tersebut: saat ini hanya nilai flag pertama yang berlaku.



Header khusus endpoint

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

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 tepat 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:

{
  "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