Claude Fable 5.2 API 快速入门

快速步骤

在代码之外配置 Claude API 凭证，使用 claude-fable-5-2 调用 Messages API，再检查文本块、stop_reason 和 usage。最小请求通过核验后，再逐项添加图片或工具。

• Claude消息 API 参考
• Claude 平台模型文档

1. 准备权限和小规模输入

使用 Claude Platform API 密钥，在本地 shell 通过 ANTHROPIC_API_KEY 环境变量提供。验证集成时只用虚构简报。密钥应保存在凭证存储中，不得写入请求日志。

2. 发送第一条消息

将示例复制到已配置密钥的 shell。请求只询问缺少的三个输入条件。响应可能包含多种内容区块，提取文字时应检查区块类型，不要假定所有区块都是文本。

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-fable-5-2","max_tokens":1024,"messages":[{"role":"user","content":"一家虚构的面包店需要制作上新宣传图。请列出撰写设计简报前要确认的三项信息。"}]}'

3. 检查实际响应

阅读文字区块，并查看 stop_reason。达到最大 token 数而结束时，需要收紧请求或调整预算。记录请求 ID、模型 ID 和 token 用量，再结合官方 API 单价对账。

• Fable 5.2成本示例

4. 一次只添加一项能力

文本请求成功后，按视觉文档的格式添加一张图片，用已知标签检验回答，再考虑工具。Fable 5.2 采用自适应思考，文档列有不支持的强制工具选择和部分采样设置；最初请求先不要加入这些选项。

• Claude愿景文档
• Fable 5.2API 变更

5. 保留可读的交接说明

设计流程的输出应为包含来源 ID、必需文案和未知项的短简报。先由人核对，再复制到 Ciyo 制作视觉。保留批准结果和来源图片 ID，便于日后重建决策。

• Ciyo设计助手

先诊断一个小请求，再连接自动化流程

认证失败应检查凭证和所属组织；请求结构报错则要读返回的错误信息与模型说明。两类问题分开处理。记录状态、请求 ID 和去除敏感信息后的错误内容，不要把密钥复制到支持记录中。

达到 token 上限而停止时，要看回答是否包含要求的三个事项。HTTP 请求成功不等于简报完整。缩小输出范围或调整上限，再核对下一次结果，最后才加入其他工具。