第 1 课
发第一条 Haiku 5.5 消息
对照官方 Overview 的模型 ID、上下文与定价，复制一条带 output_config.effort 的 curl，发出第一条 claude-haiku-5-5 请求，并按 type 取出 text。
课程目录第 1 / 2 课
学习位置仅保存在当前浏览器，有效期 180 天。
图文讲义
Claude Haiku 5.5 迁移上手：换模型 ID、adaptive thinking 与 effort
本课按官方文档整理，目标是：把现有 Haiku 4.5（或更早）的 Messages API 调用改到
claude-haiku-5-5，并成功发出一次带effort的请求。
主要来源：Overview · Migration guide · What's new · Prompting
你将得到什么
- 正确的模型 ID（各云平台对照）
- 一次可复制的
curl调用（含output_config.effort） - 从 Haiku 4.5 迁过来时最容易踩坑的 5 件事与改法
课前准备
- 准备 Anthropic API Key（环境变量
ANTHROPIC_API_KEY）。没有 key 也可以先对照改代码，真正发请求时再填。 - 本机有
curl（或任意 HTTP 客户端）。 - 若项目里还在用
claude-haiku-4-5/claude-haiku-4-5-20251001，准备好要改的文件列表。
一、先认识 Haiku 5.5（对照结果）
官方 Overview（2026-10-07 起 Active）要点：
| 项 | 值 |
|---|---|
| Model ID（Claude API） | claude-haiku-5-5（无日期后缀、无单独 alias） |
| 上下文 | 1M tokens |
| 最大输出 | 128K（Batches API 在 beta header 下可达 300K） |
| 定价（提示 ≤100K token） | 输入 $0.10 / MTok，输出 $0.50 / MTok |
| 定价（提示 >100K token） | 输入 $0.50 / MTok，输出 $2.50 / MTok |
| Thinking | Adaptive（默认开）；用 effort 控深浅 |
| 默认 effort | medium |
| 知识截止 | Jun 2026 |
分平台 ID（摘自官方迁移表）：
| 平台 | Haiku 5.5 ID |
|---|---|
| Claude API | claude-haiku-5-5 |
| Amazon Bedrock | anthropic.claude-haiku-5-5 |
| Google Cloud / Microsoft Foundry / Claude Platform on AWS | claude-haiku-5-5 |
二、动手：发第一条 Haiku 5.5 消息
把下面整段复制到终端。把密钥换成你的（或先 export ANTHROPIC_API_KEY=...）。
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-haiku-5-5",
"max_tokens": 1024,
"output_config": {"effort": "low"},
"messages": [
{
"role": "user",
"content": "用两句话总结：为什么高并发分类任务适合 Haiku 5.5？"
}
]
}'
对照结果（成功时你会看到）：
- HTTP 200
- JSON 里
model为claude-haiku-5-5（或带平台前缀的等价 ID） content是数组；元素带type字段。可能先出现thinking块，再出现text块——不要假设第一个块就是答案，按type == "text"取正文usage里会有 input/output token；同文案比 Haiku 4.5 大约多计 ~30% token（新 tokenizer）
延迟敏感场景用 effort: "low"（官方 Reducing latency 示例同款）。一般工作从 medium 起；更重的知识/agent 任务再试 high / xhigh / max（见 Prompting 文档）。
（下一课继续：从 Haiku 4.5 迁移清单与自检。）
