Making a request

学习笔记：Anthropic API 基础调用

🛠️ 环境设置与安全实践 (Setup & Security)

• 安装依赖： 在 Jupyter Notebook 中安装 Anthropic Python SDK 和 python. env 包。
• 命令：pip install Anthropic python. env
• API 密钥管理： 使用 python. env 安全地存储和加载 API 密钥。
• 安全存储规范：
• 将密钥存储在同目录下的 . env 文件中。
• 格式示例：ANTHROPIC_API_KEY="你的密钥"。
• 重要提示： 如果使用 Git 等版本控制系统，必须确保忽略（ignore）. env 文件，防止密钥泄露。

🤖 API 调用核心概念 (Core API Concepts)

• API 客户端创建： 使用 anthropic 包创建 API 客户端。
• 核心函数： 通过 client. messages. create() 方法发起请求。
• 必需参数： create() 函数需要三个关键参数：
• model (模型名称)：指定要运行的模型（例如：Claude Sonnet）。
• max_tokens (最大令牌数)：设置模型生成响应的最大预算。
• 注意： 这是一个安全机制，用于防止生成过长的文本，而非强制模型达到该数量。
• messages (消息列表)：代表对话或交互历史。

💬 消息类型 (Message Types)

• 消息的作用： 消息用于模拟对话或数据交换。
• 两种消息类型：
• User Message (用户消息)： 包含由人类（用户或开发者）编写的文本内容。
• Assistant Message (助手消息)： 包含由模型生成并返回给我们的文本内容。
• 消息结构： 每条消息都是一个字典，包含 role (角色) 和 content (内容)。

📤 结果处理 (Output Handling)

• 响应结构： API 返回的响应对象是深度嵌套的。
• 获取纯文本： 要提取模型生成的纯文本内容，需要通过路径访问：message. content[0]. text。

Takeaways

• API 密钥必须使用 python. env 安全存储，并确保在版本控制中忽略 . env 文件以防泄露。
• API 调用核心是 client. messages. create()，它必须传入 model、max_tokens 和 messages 三个关键参数。
• 对话交互由 User Message (用户输入) 和 Assistant Message (模型输出) 两种角色构成。
• 要从 API 响应中提取模型生成的纯文本内容，需要通过特定的路径访问，例如 message. content[0]. text。