Header beta

Header beta memungkinkan Anda mengakses fitur eksperimental dan kemampuan model baru sebelum fitur tersebut menjadi bagian dari API standar.

Fitur-fitur ini dapat berubah dan mungkin dimodifikasi atau dihapus dalam rilis mendatang.



Cara menggunakan header beta

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

POST /v1/messages
Content-Type: application/json
X-API-Key: YOUR_API_KEY
anthropic-beta: BETA_FEATURE_NAME

Saat menggunakan SDK, Anda dapat menentukan header beta dalam opsi permintaan:

client = Anthropic()

response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
    betas=["files-api-2025-04-14"],
)



Beberapa fitur beta sekaligus

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

anthropic-beta: feature1,feature2,feature3



Header khusus endpoint

Beberapa fitur beta dicakup pada endpoint tertentu, bukan pada parameter permintaan individual, dan memerlukan header beta khusus fitur pada setiap permintaan:

Lihat ikhtisar Managed Agents dan referensi MCP tunnels untuk detailnya.



Konvensi penamaan versi

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



Penanganan error

Jika Anda menggunakan header beta yang tidak valid atau tidak tersedia, Anda akan menerima respons error:

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "Unsupported beta header: invalid-beta-name"
  }
}



Mendapatkan bantuan

Untuk pertanyaan tentang fitur beta:

1. Periksa dokumentasi untuk fitur spesifik tersebut
2. Tinjau changelog API untuk pembaruan
3. Hubungi dukungan untuk bantuan terkait penggunaan produksi

Ingat bahwa fitur beta disediakan "apa adanya" dan mungkin tidak memiliki jaminan SLA yang sama seperti fitur API yang stabil.