1.Accessing the API
此文档由 学习AI的1000天 翻译制作(抖音，B站，YouTube)
邮箱: szqshan@gmail.com | 微信: szqshan
网址: www.xueai.org
==================================================
在构建使用Claude的应用程序时，理解完整的请求生命周期能够帮助你做出更好的架构决策并更有效地调试问题。让我们来了解一下从用户在聊天界面中点击"发送"到Claude的回复显示在屏幕上这整个过程中都发生了什么。
五步请求流程
与Claude的每次交互都遵循一个可预测的模式，包含五个不同的阶段：请求发送到服务器、请求发送到Anthropic API、模型处理、响应返回到服务器、以及响应返回到客户端。
为什么需要服务器
你绝不应该直接从客户端代码向Anthropic API发起请求。原因如下：
- API请求需要密钥API key进行身份验证
- 在客户端代码中暴露此密钥会造成严重的安全漏洞
- 任何人都可能提取该密钥并发起未授权的请求
相反，你的web或移动应用应该向你自己的服务器发送请求，然后由服务器使用安全存储的密钥与Anthropic API进行通信。
Making API Requests
当你的服务器联系Anthropic API时，你可以使用官方SDK或发起普通的HTTP请求。Anthropic为Python、TypeScript、JavaScript、Go和Ruby提供了SDK。
每个请求都必须包含以下基本字段：
- API Key - 向Anthropic标识你的请求
- Model - 要使用的模型名称（如"claude-3-sonnet"）
- Messages - 包含用户输入文本的列表
- Max Tokens - Claude可生成token数量的限制
Claude的内部处理过程
一旦Anthropic收到你的请求，Claude会通过四个主要阶段来处理它：分词、嵌入、上下文化和生成。
Tokenization
Claude首先将你的输入文本分解成称为token的小块。这些可以是完整的单词、单词的一部分、空格或符号。为简单起见，可以将每个单词想象成一个token。
Embedding
每个token都会被转换成嵌入向量——一个长数字列表，表示该单词所有可能的含义。可以将嵌入向量想象成捕获语义关系的数字定义。
单词通常具有多重含义。例如，"quantum"可以指：
- 物理量的离散单位（物理学）
- 量子力学或量子物理概念
- 极其微小或亚原子的事物
- 量子计算应用
Contextualization
Claude 根据周围词汇对每个嵌入进行精化，以确定在上下文中最可能的含义。这个过程会调整数值表示，突出显示合适的定义。
Generation
上下文化的嵌入通过输出层，计算每个可能的下一个词的概率。Claude 并不总是选择概率最高的词——它结合概率和受控随机性来创建自然、多样化的响应。
选择每个词后，Claude 将其添加到序列中，并为下一个词重复整个过程。
Claude 何时停止生成
在每个token之后，Claude 会检查几个条件来决定是否继续：
- 达到最大token数 - 是否已经达到了您指定的限制？
- 自然结束 - 是否生成了序列结束标记？
- 停止序列 - 是否遇到了预定义的停止短语？
The API Response
当生成完成时，API 会发送回一个包含以下内容的结构化响应：
- 消息 - 生成的文本
- 使用情况 - 输入和输出 token 的计数
- 停止原因 - 生成结束的原因
您的服务器接收到此响应后，将生成的文本转发回客户端应用程序，文本随即显示在用户界面中。
Key Takeaways
理解这个流程有助于您：
- 设计保护 API 密钥的安全架构
- 为您的用例设置适当的 token 限制
- 在应用程序逻辑中处理不同的停止原因
- 通过了解问题可能在管道中的哪个环节出现来调试问题
不用担心记住每个细节 - 目标是让你熟悉在使用 Claude API 时会遇到的术语和整体流程。
==================================================
此文档由 学习AI的1000天 翻译制作(抖音，B站，YouTube)
邮箱: szqshan@gmail.com | 微信: szqshan
网址: www.xueai.org