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

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

Header beta sering digunakan bersamaan dengan namespace beta dalam SDK klien

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:

from anthropic import Anthropic

client = Anthropic()

response = client.beta.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude"}
    ],
    betas=["beta-feature-name"]
)

Fitur beta bersifat eksperimental dan mungkin:

  • Memiliki perubahan yang merusak tanpa pemberitahuan
  • Ditinggalkan atau dihapus
  • Memiliki batas tarif atau harga yang berbeda
  • Tidak tersedia di semua wilayah

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

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 tepat seperti yang didokumentasikan.

Penanganan kesalahan

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

{
  "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
  2. Tinjau changelog API untuk pembaruan
  3. Hubungi dukungan untuk bantuan dengan penggunaan produksi

Ingat bahwa fitur beta disediakan “apa adanya” dan mungkin tidak memiliki jaminan SLA yang sama dengan fitur API yang stabil.