3.Making a request

此文档由 学习AI的1000天 翻译制作(抖音，B站，YouTube)

邮箱: szqshan@gmail.com | 微信: szqshan
网址: www.xueai.org

==================================================

一旦理解了基本设置和结构，向Anthropic API发出第一个请求就非常简单。本指南将介绍使用Python让Claude响应您的提示的基本步骤。

设置您的环境

在进行任何API调用之前，您需要安装所需的包并安全地配置您的API密钥。

首先，在您的Jupyter notebook中安装必要的依赖项：

%pip install anthropic python-dotenv

接下来，在与您的notebook相同的目录中创建一个.env文件来安全地存储您的API密钥：

ANTHROPIC_API_KEY="your-api-key-here"

这种方法可以将您的API密钥与代码分离，防止意外将其提交到版本控制系统。请务必将.env添加到您的.gitignore文件中。

加载环境变量并创建您的API客户端：

from dotenv import load_dotenv
load_dotenv()
from anthropic import Anthropic
client = Anthropic()
model = "claude-sonnet-4-0"

The Create Function

发起API请求的核心是client.messages.create()函数。该函数需要三个关键参数：

• model - 您想要使用的Claude模型名称
• max_tokens - 响应长度的安全限制（不是目标值）
• messages - 您发送给Claude的对话历史

max_tokens参数起到安全机制的作用。如果您将其设置为1000，即使Claude还有更多内容要说，它也会在生成1000个token后停止。Claude不会试图达到这个限制 - 它只是写出认为合适的内容，如果达到最大值就会停止。

理解消息

Messages 代表您与 Claude 之间的对话，类似于聊天应用程序。有两种类型的消息：

• 用户消息 - 您想要发送给 Claude 的内容（由人类编写）
• Assistant 消息 - Claude 生成的回复

每条消息都是一个字典，包含角色（"user" 或 "assistant"）和内容（实际文本）。

发起您的第一个请求

以下是向 Claude 发起请求的完整示例：

message = client.messages.create(
model=model,
max_tokens=1000,
messages=[
        {
"role": "user",
"content": "什么是量子计算？用一句话回答"
        }
    ]
)

当你运行这段代码时，Claude 会处理你的请求并返回一个响应对象，其中包含生成的文本以及关于该请求的元数据。

提取响应内容

响应对象包含大量信息，但通常你只需要生成的文本。可以使用以下方式访问：

message.content[0].text

这会给你清晰、可读的输出，例如："量子计算是一种利用量子力学原理（如叠加态和量子纠缠）来使用量子比特（qubits）处理信息的计算类型，在解决某些复杂问题时可能比经典计算机快指数倍。"

有了这些基础知识，你就可以开始尝试不同的提示词，并与 Claude 构建更复杂的交互。

==================================================

此文档由 学习AI的1000天 翻译制作(抖音，B站，YouTube)
邮箱: szqshan@gmail.com | 微信: szqshan
网址: www.xueai.org