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.

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

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

from anthropic import Anthropic

client = Anthropic()

response = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude"}
    ],
    extra_headers={
        "anthropic-beta": "beta-feature-name"
    }
)

Fitur beta bersifat eksperimental dan mungkin:

  • Mengalami perubahan yang merusak tanpa pemberitahuan
  • Dihentikan atau dihapus
  • Memiliki batas rate 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 persis seperti yang didokumentasikan.

Penanganan kesalahan

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 tertentu
  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 seperti fitur API yang stabil.