消息
消息示例
Messages API 的请求和响应示例
完整的可用参数文档请参见 API 参考。
基本请求和响应
JSON
多轮对话
Messages API 是无状态的,这意味着你始终需要向 API 发送完整的对话历史。你可以使用这种模式来逐步建立对话。早期的对话轮次不一定需要实际来自 Claude —— 你可以使用合成的 assistant
消息。
Shell
Python
TypeScript
JSON
预设 Claude 的回答
你可以在输入消息列表的最后位置预填充 Claude 的部分回答。这可以用来引导 Claude 的回应。下面的示例使用 "max_tokens": 1
来从 Claude 获取单个选择题答案。
JSON
视觉功能
Claude 可以在请求中读取文本和图像。我们支持图像的 base64
和 url
两种源类型,以及 image/jpeg
、image/png
、image/gif
和 image/webp
媒体类型。更多详情请参见我们的视觉指南。
JSON
工具使用、JSON 模式和计算机使用(测试版)
有关如何使用 Messages API 使用工具的示例,请参见我们的指南。 有关如何使用 Messages API 控制桌面计算机环境的示例,请参见我们的计算机使用(测试版)指南。