베타 헤더

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

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

​

베타 헤더 사용 방법

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

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

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

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"
    }
)

​

다중 베타 기능

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

anthropic-beta: feature1,feature2,feature3

​

버전 명명 규칙

베타 기능 이름은 일반적으로 다음 패턴을 따릅니다: 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 보장이 없을 수 있다는 점을 기억하세요.