claude-api

该资料是面向开发者的 Claude Messages API 使用指南，包依赖为 @anthropic-ai/sdk@0.71.2。用途是帮助在应用中调用 Claude 进行结构化数据抽取、API 响应格式化、智能体工具调用等。主要能力包括：结构化输出（beta 头 structured-outputs-2025-11-13，output_format 使用 json_schema、strict:true，或工具加 strict:true），保证 JSON 格式符合 schema，但不保证内容准确，需自行做语义校验；提示缓存（cache_control 必须置于最后一个缓存块，Sonnet 4.5 最低 1024 tokens，Haiku 4.5 最低 2048，5 分钟 TTL，仅相同内容共享，AWS Bedrock 上 Claude 4 series 不支持缓存）；SSE 流式需注册 error/abort 事件，因为错误可能出现在 200 响应之后；工具调用需让 tool_use_id 与 tool_use 块 id 匹配，并处理执行失败、清洗 U+2028/U+2029；视觉支持 JPEG/PNG/WebP/GIF，单图最大 5MB，base64 约增 33%；扩展思考仅部分模型支持且思考块不可缓存。已退役模型包括 Claude 3.5/3.7 Sonnet，当前模型为 Opus 4.5、Sonnet 4.5、Opus 4、Haiku 4.5，各自有 ID、上下文与费用。资料列出 16 类常见问题及防范，如 429 需按 retry-after 退避、系统提示应置于 messages 之前、上下文超限需裁剪、避免客户端暴露密钥等。结构化输出限制包括不支持递归 schema、数值约束、有限正则，且与引用和消息预填充不兼容。具体价格与平台支持以官方为准，部分用法细节暂未提供。