18  获取 API KEY

大模型的 API 调用通常指通过 HTTP 请求与大规模预训练模型（如 GPT、DeepSeek、Claude 等）进行交互。调用流程一般包括以下步骤：

  1. 获取 API Key：大多数模型提供方（如 OpenAI、Anthropic、Meta）都会要求用户申请 API Key 进行身份验证。
  2. 构造请求：通常使用 POST 请求发送数据，包括 prompt（输入文本）、max_tokens（最大生成长度）、temperature（控制随机性）等参数。
  3. 发送请求：通过 HTTP 客户端（如 requests、curl、axios）向 API 服务器发送 JSON 格式的数据。
  4. 接收响应：服务器返回生成的文本，通常是 JSON 格式，包含 choices 字段，其中存放模型的回答内容。
  5. 解析结果：提取并处理返回的数据，将其用于应用场景，如聊天机器人、代码补全、文本摘要等。

调用示例（Python）：

import requests

url = "https://api.example.com/v1/completions"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
data = {
    "model": "gpt-4",
    "prompt": "介绍一下机器学习",
    "max_tokens": 100
}

response = requests.post(url, json=data, headers=headers)
print(response.json()["choices"][0]["text"])

不同 API 提供商可能有不同的接口格式，但整体流程类似。

API Key 作为调用方的唯一凭证，确保只有授权用户才能访问大模型服务。每个 API Key 通常与用户账户或应用绑定。调用大模型时，客户端会在 HTTP 请求的请求头（Header）或URL 参数中附加 API Key，以表明自己的身份。大模型的服务器接收到请求后，会检查 API Key 是否有效。如果 API Key 正确且未过期，服务器才会继续处理请求；否则，会返回认证失败（401 Unauthorized）或权限不足（403 Forbidden）的错误。此外，许多大模型 API 采用按调用计费的模式，服务器会记录 API Key 的使用情况，以便进行计费、日志审计或防止滥用。

简而言之，API Key 就像一把“通行证”，用于标识和授权用户访问大模型，同时确保安全性和可控性。

18.1 获取阿里云百炼的 API KEY

要获取阿里云百炼的 API Key，请按照以下步骤操作（详细图文步骤请参见官方文档）：

  1. 登录阿里云百炼大模型服务平台：使用您的阿里云账号登录 阿里云百炼大模型服务平台。

  2. 开通百炼模型服务：如果登录后在页面顶部看到提示，要求开通百炼模型服务，请按照提示操作，以获得免费额度。开通百炼本身不产生费用，只有在调用、部署或调优模型时，超出免费额度部分才会产生相应费用。

  3. 进入 API Key 管理界面：将鼠标悬停在页面右上角的头像图标上，在下拉菜单中点击“API-KEY”。在左侧导航栏中，选择“全部API-KEY”或“我的API-KEY”。主账号可以查看和管理所有子账号的 API Key，子账号仅能查看和管理自己的 API Key。

  4. 创建或查看 API Key：在对应的页面中，点击“创建”按钮以生成新的 API Key，或在已有的 API Key 操作列中点击“查看”以获取现有的 API Key。请注意，删除 API Key 后，使用该 Key 的服务将无法继续访问百炼大模型提供的各项服务。

18.2 获取 DeepSeek 的 API KEY

要获取 DeepSeek 的 API Key，请按照以下步骤操作：

  1. 注册或登录 DeepSeek 平台：
    • 访问 DeepSeek 官方网站。
    • 如果您已有账号，请直接登录；如果没有，请按照指引注册新账号。
  2. 创建 API Key：
    • 登录后，点击左侧导航栏中的“API Keys”选项。
    • 在“API Keys”页面，点击“创建 API Key”按钮。
    • 为您的 API Key 输入一个描述性的名称，以便日后管理。
    • 创建后，系统会生成一个唯一的 API Key。请务必立即复制并妥善保存，因为出于安全原因，您将无法在平台上再次查看该密钥。

18.3 获取 ChatGPT 的 API KEY

ChatGPT 官方服务中国地区不可用，这里介绍 ChatAnyWhere 接口 API KEY 的办法。要获取 ChatAnyWhere 的 API Key，请按照以下步骤操作：

  • 🚀申请领取内测免费API Key
  • 免费版支持gpt-3.5-turbo, embedding, gpt-4o-mini, gpt-4。其中gpt-4由于价格过高，每天限制3次调用（0点刷新）。需要更稳定快速的gpt-4请使用付费版。
  • 免费版gpt-4由gpt-4o提供服务，但免费版暂不支持识图。
  • 转发Host1: https://api.chatanywhere.tech (国内中转，延时更低)
  • 转发Host2: https://api.chatanywhere.org (国外使用)

付费版API

  • 纯公益提供免费Key显然不是能持久运营下去的方案，所以我们引入付费API Key维持项目的日常开销，以促进项目的良性循环，还望大家理解。
  • 购买付费Key
  • 付费版价格表
  1. 支持更稳定更快速的GPT4 API，GPT4体验更好，无限使用，价格低于官方，充值更便捷。
  2. 同官网计费策略，流式问答使用tiktoken库准确计算Tokens，非流式问答直接使用官方返回Tokens用量计费。
  3. 余额不会过期，永久有效。根据用户反馈30块钱个人中度使用gpt-4o-mini估计能用半年。
  4. 所有的接口（包括免费版本）都保证转发自OpenAI或Azure官方接口，非peo、plus等不稳定方案或逆向方案，无水分，不掺假，保证稳定性。

付费版支持更多主流AI模，型包括 GPT-4、GPT-4o、o1-preview 及其变种，以及 Claude、Gemini 等第三方模型，均支持自然语言处理任务。

GPT-4o-mini系列价格较低，适用于一般任务，而 GPT-4o 系列在性能、速度和多模态能力上更优，支持图片输入并提供高性价比。GPT-4-Turbo 提供 128K 上下文窗口，适用于长文本处理。Claude 3.5、Gemini 1.5 等模型由第三方提供，适用于复杂推理任务，但可能存在稳定性问题。

此外，DALL-E 3 支持高质量图像生成，TTS-1 用于文本转语音，Whisper 则用于语音识别。OpenAI 的 embedding 模型如 text-embedding-3 适用于文本向量化任务。

18.4 获取 Huggingface 的 API KEY

获取 Hugging Face 的 API Key 步骤如下：

  1. 登录 Hugging Face
    访问 Hugging Face 官网 并登录你的账户。如果没有账户，需要先注册。

  2. 进入 API Key 页面
    点击右上角的个人头像，选择 “Settings”（设置），然后在左侧菜单中找到 “Access Tokens”。

  3. 生成 API Key
    在 Access Tokens 页面，点击 “New token”（新建 Token），输入 Token 名称，并选择权限（一般选择 “Write” 或 “Read”）。

  4. 复制 API Key
    生成后，复制 API Key 并妥善保存，因为它只会显示一次。

18.5 使用注意事项

  • 保密：请勿以任何方式公开您的 API Key，以避免未经授权的使用带来安全风险或资金损失。API Key 是重要的鉴权凭证，请妥善保管（特别有些 API KEY 只在生成时显示一次）。
  • 获取 API Key 后，建议将其配置到环境变量中，以便在调用模型或应用时使用，从而降低 API Key 泄漏的风险。详细操作请参考 配置 API Key 到环境变量。

18.5.1 在 Linux/MacOS 系统中配置环境变量

18.5.1.1 临时设置（当前终端会话有效）

在终端中运行以下命令（以 Hugging Face 为例）：

export HF_API_KEY="your_huggingface_api_key"

这只会在当前终端会话中生效，关闭终端后失效。

18.5.1.2 永久设置（适用于所有终端）

编辑 ~/.bashrc（适用于 Bash）或 ~/.zshrc（适用于 Zsh）：

echo 'export HF_API_KEY="your_huggingface_api_key"' >> ~/.zshrc
source ~/.zshrc  # 使更改生效

其他 API（如阿里云百炼、ChatAnywhere、DeepSeek）类似：

echo 'export BAILIAN_API_KEY="your_bailian_api_key"' >> ~/.zshrc
echo 'export CHATANYWHERE_API_KEY="your_chatanywhere_api_key"' >> ~/.zshrc
echo 'export DEEPSEEK_API_KEY="your_deepseek_api_key"' >> ~/.zshrc
source ~/.zshrc

18.5.2 在 Windows 系统中配置环境变量

18.5.2.1 临时设置（当前终端会话有效）

在命令提示符（CMD）中运行：

set HF_API_KEY=your_huggingface_api_key

在 PowerShell 中运行：

$env:HF_API_KEY="your_huggingface_api_key"

18.5.2.2 永久设置（适用于所有终端）

  1. 打开 “环境变量”（Win + R，输入 sysdm.cpl，然后选择 “高级” -> “环境变量”）。
  2. 在 “系统变量” 或 “用户变量” 中点击 “新建”，输入变量名 HF_API_KEY，变量值 your_huggingface_api_key。
  3. 点击 “确定”，然后重新启动终端。

其他 API 配置方式相同，替换 HF_API_KEY 为相应的 API 变量名。

18.5.3 在 R 中配置环境变量

18.5.3.1 临时设置（当前 R 会话有效）

Sys.setenv(HF_API_KEY = "your_huggingface_api_key")

18.5.3.2 永久设置（适用于所有 R 会话）

编辑 ~/.Renviron 文件（Linux/MacOS）或 C:\Users\你的用户名\Documents\.Renviron（Windows），添加：

HF_API_KEY=your_huggingface_api_key

保存后，重新启动 R。

18.5.4 在 Python 中配置环境变量

18.5.4.1 临时设置（当前 Python 进程有效）

import os
os.environ["HF_API_KEY"] = "your_huggingface_api_key"

18.5.4.2 永久设置（适用于所有 Python 进程）

  • 方法 1：写入 shell 配置文件（Linux/MacOS）

    echo 'export HF_API_KEY="your_huggingface_api_key"' >> ~/.zshrc
source ~/.zshrc

  • 方法 2：写入 .env 文件（适用于 python-dotenv 库）
    创建 .env 文件，添加：

    HF_API_KEY=your_huggingface_api_key

    然后在 Python 代码中加载：

    from dotenv import load_dotenv
load_dotenv()  # 自动加载 .env 文件
import os
print(os.getenv("HF_API_KEY"))

其他 API 的配置方式相同，替换 HF_API_KEY 为 BAILIAN_API_KEY、CHATANYWHERE_API_KEY、DEEPSEEK_API_KEY 等。