企业官网建设流程全解析

model字段必须填精确字符串，不能用昵称。当前主力：claude-sonnet-4-6；轻量高频：claude-haiku-4-5-20251001（日期后缀必须完整）；旗舰推理：claude-opus-4-8。

当前全部可用 Model ID

Opus 4 系列（旗舰推理）

Sonnet 4 系列（主力均衡）

Haiku 4 系列（轻量高频）

错误写法速查表

两条规律：全程用连字符不用点号；有日期后缀的必须完整填写。

OpenAI SDK 接入示例

fromopenaiimportOpenAI client=OpenAI(api_key="sk-xxx",base_url="https://gw.claudeapi.com/v1"# 注意带 /v1)# 基础调用response=client.chat.completions.create(model="claude-sonnet-4-6",messages=[{"role":"user","content":"用 Python 写一个快速排序"}],max_tokens=2048)print(response.choices[0].message.content)

# 流式输出stream=client.chat.completions.create(model="claude-sonnet-4-6",messages=[{"role":"user","content":"写一篇关于 RAG 的技术文章"}],max_tokens=4096,stream=True)forchunkinstream:ifchunk.choices[0].delta.content:print(chunk.choices[0].delta.content,end="",flush=True)

Anthropic Native SDK 接入示例

importanthropic# Anthropic Native SDK 接入 ClaudeAPI（不带 /v1）client=anthropic.Anthropic(api_key="sk-xxx",base_url="https://gw.claudeapi.com"# 注意：不带 /v1)# 基础调用message=client.messages.create(model="claude-sonnet-4-6",max_tokens=1024,messages=[{"role":"user","content":"解释 Python 的 GIL 是什么"}])print(message.content[0].text)

# 流式输出withclient.messages.stream(model="claude-sonnet-4-6",max_tokens=2048,messages=[{"role":"user","content":"写一篇关于 RAG 架构的技术文章"}],)asstream:fortextinstream.text_stream:print(text,end="",flush=True)

⚠️两种 SDK 的 Base URL 不同：

• OpenAI SDK：https://gw.claudeapi.com/v1（带/v1）
• Anthropic SDK：https://gw.claudeapi.com（不带/v1）
• 混用时一定分开配置，否则报 404

模型分层调用（成本优化实战）

同一个 AI 应用里，不同任务复杂度差异很大——全用 Opus 贵，全用 Haiku 质量不够。分层路由是生产项目必备：

# 三层路由配置（按任务复杂度）MODEL_ROUTING={# 轻量任务：格式化、路由判断、初筛 → Haiku"format":"claude-haiku-4-5-20251001","route":"claude-haiku-4-5-20251001","filter":"claude-haiku-4-5-20251001",# 主力任务：代码生成、内容撰写、数据分析 → Sonnet"code":"claude-sonnet-4-6","content":"claude-sonnet-4-6","analysis":"claude-sonnet-4-6",# 旗舰任务：复杂推理、长文档、多 Agent → Opus"reasoning":"claude-opus-4-8","legal":"claude-opus-4-8","multiagent":"claude-opus-4-8",}defget_model(task_type:str)->str:returnMODEL_ROUTING.get(task_type,"claude-sonnet-4-6")# 默认 Sonnetdefrun_task(task_type:str,prompt:str)->str:model=get_model(task_type)resp=client.chat.completions.create(model=model,messages=[{"role":"user","content":prompt}],max_tokens=2048)print(f"[{task_type}] →{model}")returnresp.choices[0].message.content

成本对比（ClaudeAPI 价格，100 万 token 内容生成）：

批量验证脚本

上线前验证所有用到的 Model ID 都有效：

importhttpx,json API_KEY="sk-xxx"BASE_URL="https://gw.claudeapi.com/v1"# 你项目中用到的所有 Model IDMODELS_TO_CHECK=["claude-opus-4-8","claude-opus-4-7","claude-opus-4-6","claude-opus-4-5-20251101","claude-sonnet-4-6","claude-sonnet-4-5-20250929","claude-haiku-4-5-20251001",]defget_available_models()->set[str]:resp=httpx.get(f"{BASE_URL}/models",headers={"Authorization":f"Bearer{API_KEY}"},timeout=10)resp.raise_for_status()return{m["id"]forminresp.json()["data"]}available=get_available_models()print(f"✅ 当前可用模型数：{len(available)}\n")formodel_idinMODELS_TO_CHECK:status="✅ 可用"ifmodel_idinavailableelse"❌ 不可用（检查 ID 或联系支持）"print(f"{model_id:45s}{status}")

环境变量与 CLI 别名

# 写入 ~/.bashrc 或 ~/.zshrcexportANTHROPIC_BASE_URL="https://gw.claudeapi.com"exportANTHROPIC_API_KEY="sk-xxx"exportOPENAI_BASE_URL="https://gw.claudeapi.com/v1"exportOPENAI_API_KEY="sk-xxx"# 快速测试别名aliasclaude-test='curl -s $OPENAI_BASE_URL/chat/completions \ -H "Authorization: Bearer $OPENAI_API_KEY" \ -H "Content-Type: application/json" \ -d "{\"model\": \"claude-sonnet-4-6\", \"messages\": [{\"role\": \"user\", \"content\": \"hi\"}], \"max_tokens\": 10}" \ | python3 -m json.tool'aliasclaude-models='curl -s $OPENAI_BASE_URL/models \ -H "Authorization: Bearer $OPENAI_API_KEY" | python3 -m json.tool'

CLI 别名踩坑：

写在最后

新项目选型不用纠结，三步走：

1. 默认claude-sonnet-4-6先跑起来
2. 某类任务质量不够 → 切claude-opus-4-8
3. 有明显轻量任务（补全/格式化）→ 切claude-haiku-4-5-20251001

Model ID 填错是最常见的接入问题，碰到model not found先对照本文速查表逐字检查。

如果需要查看持续更新版本，参考 ClaudeAPI 官网原文。