ToAPIs

Claude Haiku 4.5 完整解析（Markdown）

返回模型解析页

Claude Haiku 4.5 API 模型解析指南

快速结论

  • 编码场景表现强：代码生成、解释、重构、单测补全与 Bug 定位都能覆盖。
  • 支持 Anthropic Messages + tools，可把“写代码”和“执行工具”串成一条链路。
  • 支持 stream=true 的 SSE 增量返回，适合 IDE Copilot、终端助手和实时 Agent。

核心能力

  • 面向软件开发的实战编程能力：擅长函数实现、错误修复、代码重构与测试补全，适合在真实工程上下文中处理连续编码任务。
  • 强大的工具调用与 API 编排：支持 Messages + tools + input_schema，可把“分析代码、调用工具、继续推理”串成自动化工作流。
  • 低延迟流式响应：支持 stream=true 的 SSE 增量返回，适合 IDE 辅助、终端助手和实时交互式 Agent。
  • 稳定的多步问题拆解：在多轮上下文下保持较好的任务一致性，适合排查复杂 bug、分步骤修改代码并收敛到可执行方案。
  • 工程级可控输出：可通过 system 指令、temperature、tool_choice 控制输出风格与确定性，便于接入生产流水线。
  • 生产可用的安全与治理策略：结合鉴权、限流、重试、schema 校验等机制，能在企业环境中更稳健地落地编码能力。

适用场景

  • 需要高频编码辅助：函数实现、错误修复、代码解释、重构建议。
  • 需要低延迟、可扩展成本的在线编程助手或开发工作流。
  • 需要工具调用：让模型先分析，再触发测试、检索、执行等外部动作。

不适用场景

  • 需要超长链路的深度架构推理或复杂科研决策时。
  • 单次输出超长文档、且对最强推理上限有刚性要求时。

运行特性

  • 消息入口为 POST /v1/messages，遵循 ToAPIs 文档约定。
  • stream=true 时返回 SSE 事件流，常见事件包括 message_start、content_block_delta、message_stop。
  • 函数调用通过 tool_use 内容块返回；工具场景下 stop_reason 通常为 tool_use。
  • 接口为无状态调用，多轮上下文需要业务侧在 messages 中自行携带。

最小请求示例

{
  "model": "claude-haiku-4-5",
  "system": "你是资深 TypeScript 工程师。先给修复思路，再给最小改动代码和测试建议。",
  "messages": [
    {
      "role": "user",
      "content": "请修复这个函数的空值 bug，并给出一个最小单测示例：function getName(u){ return u.profile.name.trim() }"
    }
  ],
  "tools": [
    {
      "name": "run_tests",
      "description": "运行指定测试文件并返回失败摘要",
      "input_schema": {
        "type": "object",
        "properties": {
          "file": {
            "type": "string",
            "description": "测试文件路径"
          }
        },
        "required": [
          "file"
        ]
      }
    }
  ],
  "temperature": 0.2,
  "max_tokens": 300,
  "stream": false
}

最小响应示例

{
  "id": "msg_xxxxxxxx",
  "type": "message",
  "model": "claude-haiku-4-5",
  "stop_reason": "tool_use",
  "content": [
    {
      "type": "tool_use",
      "id": "toolu_xxxxxxxx",
      "name": "run_tests",
      "input": {
        "file": "src/utils/get-name.test.ts"
      }
    }
  ],
  "usage": {
    "input_tokens": 120,
    "output_tokens": 48
  }
}

关键参数

参数类型必填默认值范围说明
modelstring是claude-haiku-4-5-模型名称，使用当前页面模型 ID（例如 claude-haiku-4-5）。
messagesobject[]是--对话消息列表，按时间顺序排列；仅支持 user 和 assistant 角色。
max_tokensinteger是->=1生成内容的最大 token 数量。
systemstringobject[]否--
streamboolean否false-是否启用流式输出（SSE）。
temperaturenumber否10-1采样温度，控制输出随机性。
top_pnumber否-0-1核采样概率阈值，建议不要同时设置 temperature 和 top_p。
stop_sequencesstring[]否--停止序列，遇到指定字符串时停止生成。
AuthorizationHTTP Header否--Bearer Token 认证：Authorization: Bearer <YOUR_API_KEY>。
x-api-keyHTTP Header否--API Key 认证（Anthropic SDK 常用），与 Authorization 二选一。
anthropic-versionHTTP Header否2023-06-01-Anthropic API 版本号；使用 Anthropic SDK 时通常自动传入。

常见错误

HTTPCode触发条件修复建议重试策略
400invalid_request_error请求体字段缺失、messages 结构错误或参数类型不匹配。重点校验 model、messages、max_tokens 字段及类型。修正参数后再重试。
401authentication_errorAuthorization 缺失、格式错误或密钥无效。确认 Bearer Token 与密钥权限。修复鉴权后重试。
429rate_limit_exceeded请求频率、并发或当前额度命中上游限流策略。先做指数退避重试，并检查当前请求节奏、并发设置和额度使用情况。建议 1s/2s/4s + 抖动；连续触发时再收紧提交节奏。

FAQ

  1. Claude Haiku 4.5 在编码场景最适合做什么？
    最适合高频、低延迟任务：补全函数、解释报错、重构片段、生成测试样例、产出 PR 说明等。
  2. 怎么链接 API（最短路径）？
    准备 API Key 后，用 Authorization: Bearer 鉴权，POST 到 /v1/messages，在 body 传 model、messages、max_tokens。
  3. 工具调用怎么接？
    在请求中传 tools + input_schema，响应出现 tool_use 后执行对应函数，再把结果回传给模型继续下一轮。
  4. 流式输出如何处理？
    设置 stream=true 后按 SSE 事件增量处理内容；编码工具场景里注意处理 content_block_delta 与最终 stop_reason。

相关 API