使用 API
Beta 标头
使用 Anthropic API 的 beta 标头的文档
Beta 标头允许您在实验性功能和新模型能力成为标准 API 的一部分之前访问它们。
这些功能可能会发生变化,并可能在未来版本中被修改或移除。
Beta 标头通常与客户端 SDK 中的 beta 命名空间结合使用
如何使用 beta 标头
要访问 beta 功能,请在您的 API 请求中包含 anthropic-beta
标头:
使用 SDK 时,您可以在请求选项中指定 beta 标头:
Beta 功能是实验性的,可能会:
- 在没有通知的情况下发生破坏性变更
- 被弃用或移除
- 具有不同的速率限制或定价
- 在所有地区都不可用
多个 beta 功能
要在单个请求中使用多个 beta 功能,请在标头中包含所有功能名称,用逗号分隔:
版本命名约定
Beta 功能名称通常遵循以下模式:feature-name-YYYY-MM-DD
,其中日期表示 beta 版本发布的时间。始终使用文档中记录的确切 beta 功能名称。
错误处理
如果您使用无效或不可用的 beta 标头,您将收到错误响应:
获取帮助
有关 beta 功能的问题:
- 查看特定功能的文档
- 查看 API 更新日志以获取更新
- 联系支持以获得生产使用方面的帮助
请记住,beta 功能是”按原样”提供的,可能没有与稳定 API 功能相同的 SLA 保证。