Python 中的 Claude API 入门

在本文中,您将学习如何在 Python 中使用 Claude API、发出第一个请求以及使用官方 SDK 处理响应。

来源:KDnuggets

简介

您想要将 Claude 添加到 Python 应用程序。创建帐户并进行第一次 API 调用非常简单。官方文档可以让你在几分钟内从零到一个工作请求。接下来的问题通常更实际:

  • 响应对象包含什么?
  • 如何传输响应以便用户可以看到生成的输出?
  • 如何在生产应用程序中构造提示并处理响应?
  • Claude Python SDK 负责大部分底层 API 交互。它提供类型化响应对象、内置重试处理以及用于使用消息 API 的简单接口。

    本文将引导您完成设置、第一次 API 调用、读取响应、系统提示和流式传输。到最后,你将拥有一个工作基础。

    先决条件和安装

    您需要 Python 3.9 或更高版本、免费的 Claude Console 帐户以及控制台的“设置”>“API 密钥”页面中的 API 密钥。您可以添加 5 美元的积分并完成本文中的所有内容。

    就位后,安装 SDK:

    切勿在源文件中硬编码您的 API 密钥。将其存储为环境变量:

    导出 ANTHROPIC_API_KEY="YOUR-API-KEY-HERE"

    或者,如果您使用的是 python-dotenv,请将其添加到项目根目录下的 a.env 文件中。 SDK 从您的环境中读取 ANTHROPIC_API_KEY,因此您无需将其传递到代码中的任何位置。

    进行您的第一个 API 调用

    每次交互的入口点是 client.messages.create()。让我们请 Claude 解释一下什么是上下文窗口,这是您在使用 API 时实际上需要理解的内容。

    您传递三件事:模型 ID、max_tokens 限制和消息列表。消息列表始终是一个字典列表,每个字典都有一个“角色”和“内容”键。

    示例输出:

    上下文窗口是一种语言可以容纳的最大文本量(以标记为单位)

    模型可以同时处理和考虑,包括您的输入及其输出。

    理解响应对象

    使用系统提示后续步骤