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 标头：

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



多个 Beta 功能

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

anthropic-beta: feature1,feature2,feature3



特定端点的标头

某些 Beta 功能的作用范围是特定端点而非单个请求参数，并且要求在每个请求中包含特定于该功能的 Beta 标头：

详情请参阅托管代理概述。



版本命名约定

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 保证。