베타 헤더

베타 헤더를 사용하면 실험적 기능과 새로운 모델 기능이 표준 API의 일부가 되기 전에 미리 접근할 수 있습니다.

이러한 기능은 변경될 수 있으며 향후 릴리스에서 수정되거나 제거될 수 있습니다.



베타 헤더 사용 방법

베타 기능에 접근하려면 API 요청에 anthropic-beta 헤더를 포함하세요:

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

SDK를 사용할 때는 요청 옵션에서 베타 헤더를 지정할 수 있습니다:

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"],
)



여러 베타 기능 사용

단일 요청에서 여러 베타 기능을 사용하려면 모든 기능 이름을 쉼표로 구분하여 헤더에 포함하세요:

anthropic-beta: feature1,feature2,feature3



엔드포인트별 헤더

일부 베타 기능은 개별 요청 매개변수가 아닌 특정 엔드포인트에 한정되며, 모든 요청에 기능별 베타 헤더가 필요합니다:

자세한 내용은 Managed Agents 개요를 참조하세요.



버전 명명 규칙

베타 기능 이름은 일반적으로 feature-name-YYYY-MM-DD 패턴을 따르며, 날짜는 베타 버전이 릴리스된 시점을 나타냅니다. 항상 문서에 명시된 정확한 베타 기능 이름을 사용하세요.



오류 처리

유효하지 않거나 사용할 수 없는 베타 헤더를 사용하면 오류 응답을 받게 됩니다:

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



도움 받기

베타 기능에 대한 문의 사항이 있는 경우:

1. 해당 기능에 대한 문서를 확인하세요
2. 업데이트 내용은 API 변경 로그를 검토하세요
3. 프로덕션 사용에 대한 지원이 필요하면 지원팀에 문의하세요

베타 기능은 "있는 그대로" 제공되며 안정적인 API 기능과 동일한 SLA 보장이 적용되지 않을 수 있다는 점을 유의하세요.