claude-haiku-4-5-20251001 (联网搜索)

来源: https://docs.surgeai.one/docs/allapi/Claude/claude-haiku-4-5-20251001/openai-format/web-search

联网搜索 API 的 OpenAI 格式。

联网搜索 API 的 OpenAI 格式。

身份验证

在 https://surgeai.one 注册 SurgeAI 账户

在控制台中导航到 API Keys 部分

生成一个新的 API 密钥 (sk-xxxxx)

复制并安全存储您的 API 密钥

参数	类型	必填	默认值	描述
`model`	string	是	`claude-haiku-4-5-20251001`	请求使用的模型
`messages`	array	是	`[{"role": "user", "content": "What's the weather in NYC?"}]`	对话的消息对象数组。每条消息必须包含 role（user 或 assistant）和 content。
`tools`	array	是	-	工具对象数组。对于联网搜索，必须包含 web_search 工具配置。
`stream`	boolean	否	`false`	是否流式传输响应
`temperature`	number	否	`1.0`	注入响应的随机性量。范围从 0.0 到 1.0
`top_p`	number	否	`1.0`	使用核采样。范围从 0.0 到 1.0
`max_tokens`	integer	否	-	停止前生成的最大 token 数量
`stop`	array	否	-	导致模型停止生成的自定义文本序列

字段	类型	必填	描述
`role`	string	是	消息的角色。可以是：`user`、`assistant` 或 `system`
`content`	array/string	是	消息的内容

字段	类型	必填	示例	描述
`type`	string	是	`text`	内容类型
`text`	string	是	`"What's the weather in NYC?"`	当 type 为 `text` 时的文本内容

对于联网搜索功能，tools 数组应包含一个联网搜索工具对象：

字段	类型	必填	示例	描述
`type`	string	是	`web_search`	工具类型。联网搜索必须是 `web_search`
`max_uses`	integer	否	`5`	单个请求中联网搜索工具最多可使用的次数
`allowed_domains`	array	否	`["example.com", "trusteddomain.org"]`	仅包含来自这些域名的搜索结果
`blocked_domains`	array	否	`["untrustedsource.com"]`	永不包含来自这些域名的搜索结果

max_uses 参数限制执行的搜索次数。如果 Claude 尝试的搜索次数超过允许值，联网搜索结果将返回带有 max_uses_exceeded 错误码的错误。

使用域名过滤器时：

域名不应包含 HTTP/HTTPS 协议（使用 example.com 而不是 https://example.com）

子域名会自动包含在内（example.com 包含 docs.example.com）

特定子域名会将结果限制为仅该子域名（docs.example.com 仅返回来自该子域名的结果，不包含 example.com 或 api.example.com）

支持子路径（example.com/blog）

可以使用 allowed_domains 或 blocked_domains，但不能在同一个请求中同时使用

{
  "type": "web_search_20250305",
  "name": "web_search",
  "max_uses": 5,
  "allowed_domains": ["example.com", "trusteddomain.org"]
}

错误码	错误名称	描述
401	Unauthorized	API 密钥缺失或无效
403	Forbidden	您的 API 密钥没有访问此资源的权限，或请求操作的余额不足
429	Too Many Requests	您已超出速率限制
500	Internal server error	发生内部服务器错误
503	Content policy violation	内容因安全问题被阻止（实际状态码为 400）