Beta 标头

Beta 标头允许您在功能成为标准 API 的一部分之前访问实验性功能和新的模型能力。

这些功能可能会发生变化，并且可能在未来的版本中被修改或移除。

​

如何使用 beta 标头

要访问 beta 功能，请在您的 API 请求中包含 anthropic-beta 标头：

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

当使用 SDK 时，您可以在请求选项中指定 beta 标头：

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

​

多个 beta 功能

要在单个请求中使用多个 beta 功能，请在标头中包含所有功能名称，用逗号分隔：

anthropic-beta: feature1,feature2,feature3

​

版本命名约定

Beta 功能名称通常遵循以下模式：feature-name-YYYY-MM-DD，其中日期表示 beta 版本发布的时间。始终使用文档中记录的确切 beta 功能名称。

​

错误处理

如果您使用了无效或不可用的 beta 标头，您将收到错误响应：

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

​

获取帮助

关于 beta 功能的问题：

1. 查看特定功能的文档
2. 查看 API 更新日志 以获取更新
3. 联系支持团队以获取生产使用帮助

请记住，beta 功能是”按原样”提供的，可能不具有与稳定 API 功能相同的 SLA 保证。