用途:提供 Anthropic Claude Messages API 的最小可用示例,覆盖基础文本补全、视觉(图像分析)和流式响应三种核心用法,适合在新建 Claude 集成、测试环境配置或学习 Messages API 时使用。
主要能力:示例一用 Python 调用 client.messages.create 发送文本消息,并展示响应结构(content[0].text、id、model、stop_reason、usage 的输入输出 token 数);示例二用 TypeScript 读取本地图片转 base64,以 image 内容块加 text 内容块请求模型描述图表;示例三用 Python 的 client.messages.stream 逐段输出文本,并通过 get_final_message 获取完整元数据与 token 用量。
使用方式:前置条件为完成 anth-install-auth 设置、环境中存在有效的 ANTHROPIC_API_KEY,以及 Python 3.8+ 配 anthropic 包或 Node.js 18+ 配 @anthropic-ai/sdk。建议先用固定短提示验证凭据,确认 message.content[0].text 存在后再接入应用代码;视觉示例应在验证通过后使用,并将 chart.png 替换为非敏感的本地测试文件;需要交互式命令行输出时使用流式示例。
关键参数:model(如 claude-sonnet-4-20250514、claude-haiku-4-20250514、claude-opus-4-20250514)、max_tokens、messages 为必填;system、temperature、top_p、stop_sequences、stream 为可选。
错误处理:401 认证错误检查 API 密钥;400 请求参数错误校验请求体;429 限流需实现退避;529 服务过载可 30-60 秒后重试;500 服务器错误用指数退避重试。
限制:资料未提供收费、价格、平台支持范围及具体性能效果等信息;示例中的模型 ID 与参数以官方文档为准。