AI 部署指南

Appearance

API Key 管理与多模型切换 ​

一句话 ​

用国内中转站（如 API2D）统一管理 OpenAI、Claude、DeepSeek 等多模型 API，只需一个 Key、一个支付渠道即可切换任意模型，无需分别注册、绑卡或翻墙。

快速部署（AI 版） ​

前置条件 ​

  • 拥有一个可用的国内中转站账号（推荐 API2D）
  • 完成实名认证并充值（支持支付宝，最低 10 元起）
  • 准备好调用端环境：Python 3.8+ 或 curl

步骤 ​

  1. 在中转站创建 API Key

    • 登录 API2D，进入「API Key」管理页面
    • 点击「创建密钥」，复制生成的 sk-xxx 格式的密钥
    • 记录下 API 端点地址（默认为 https://api2d.com/v1）

  2. 设置环境变量（可选，推荐）

    bash
    export API2D_KEY="sk-你的密钥"
export API2D_BASE="https://api2d.com/v1"

  3. 调用 DeepSeek 模型（示例）

    bash
    curl ${API2D_BASE}/chat/completions \
  -H "Authorization: Bearer ${API2D_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role": "user", "content": "你好！"}]
  }'

  4. 切换为 Claude 模型（仅改模型名）

    bash
    curl ${API2D_BASE}/chat/completions \
  -H "Authorization: Bearer ${API2D_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3-5-sonnet-20241022",
    "messages": [{"role": "user", "content": "你好！"}]
  }'

  5. 用 Python 统一调用（推荐）

    python
    import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("API2D_KEY"),
    base_url=os.getenv("API2D_BASE")
)

# 切换模型只需改 model 参数
model = "gpt-4o"   # 或 "claude-3-5-sonnet-20241022" 或 "deepseek-chat"
response = client.chat.completions.create(
    model=model,
    messages=[{"role": "user", "content": "Hello"}]
)
print(response.choices[0].message.content)

验证 ​

执行上述 Python 脚本，如果正常返回内容，说明 Key 和端点配置成功。
尝试切换 model 为 claude-3-5-sonnet-20241022 再运行一次，若能返回 Claude 的回答，证明多模型切换生效。

详细教程（人类版） ​

背景 ​

为什么需要 API Key 统一管理？
开发者常常需要同时使用多个大语言模型：

  • Claude 擅长长文本和代码分析；
  • GPT-4o 多模态能力强；
  • DeepSeek 性价比极高，适合批量任务。

但每个模型厂商都有独立的注册、API Key、计费系统和网络访问要求。

  • OpenAI/GPT：需海外信用卡、部分地区需翻墙。
  • Claude：同样要求海外支付，且注册门槛更高。
  • DeepSeek：国内可直接用，但又要维护另一套 Key。

中转站（Proxy）的作用
国内中转站（如 API2D、OhMyGPT、AIPROXY）作为统一的 API 网关：

  • 对接多家模型的官方 API，提供兼容 OpenAI 格式的接口。
  • 支持支付宝充值，无需外币卡。
  • 服务器部署在国内，可直接访问，无需翻墙。
  • 一个 Key 管理所有模型，余额互通，自动扣费。

为什么选择 API2D 为例？

  • 国内运营稳定，已运营超过两年。
  • 支持模型丰富：GPT-4/4o、Claude 3.5 Sonnet/Haiku、DeepSeek V3/R1、Gemini 2.0 Flash 等。
  • 提供完整的 REST API，与 OpenAI SDK 完全兼容。
  • 有详细的文档和客服响应。

常见问题 ​

Q1: 中转站的 API 跟官方 API 完全一样吗？
对常用接口（Chat Completions、Embeddings、Images）高度兼容。调用方式完全参考 OpenAI 官方格式，只需修改 base_url 和 api_key。部分模型特有参数（如 Claude 的 max_tokens 改为 max_tokens）已适配，可直接使用。

Q2: 多模型切换时如何控制成本？
中转站统一按 token 计费，价格略高于官方（通常上浮 10%~30%），但免去了注册多个账户的麻烦。你可以在代码中按模型名配置不同阈值：

python
cost_limit = {"gpt-4o": 0.02, "deepseek-chat": 0.001}
response = client.chat.completions.create(model=model, ...)
if response.usage.total_tokens * cost_per_token > budget:
    raise Exception("预算超限")

Q3: 我的应用需要同时调用多个模型，如何保证并发不超限？
中转站一般没有严格的并发限制，但建议：

  • 使用 asyncio 或线程池控制并发数（如 5-10 个）。
  • 为每个模型设置独立的 semaphore。
  • 监控余额，避免突发请求耗尽余额。

Q4: 如果中转站挂了，如何切换到另一个？
提前准备 2~3 个备用中转站（如 OhMyGPT + AIPROXY），在代码中实现 fallback：

python
backends = [
    ("https://api2d.com/v1", os.getenv("API2D_KEY")),
    ("https://ohmygpt.com/v1", os.getenv("OHMYGPT_KEY")),
]
for base, key in backends:
    try:
        client = OpenAI(api_key=key, base_url=base)
        response = client.chat.completions.create(...)
        return response
    except Exception as e:
        print(f"{base} failed: {e}")
        continue

Q5: 如何管理多个项目的 API Key 权限？
中转站通常支持创建多个子 Key，每个子 Key 可设置：

  • 允许调用的模型列表（如只允许 DeepSeek）。
  • 每日消费限额。
  • 绑定 IP 白名单。
    建议为每个项目或环境（dev / prod）单独创建 Key，方便隔离和审计。

成本对比（以 100 万 token 为例，2026年7月参考价格）

模型官方价格 (美元)中转站价格 (人民币)备注
GPT-4o$5/1M input约 45 元含汇率与通道费
Claude 3.5 Sonnet$3/1M input约 28 元同上
DeepSeek V3$0.27/1M input约 2.5 元性价比极高

中转站价格每日浮动，但整体比官方贵 15%～30%，考虑到支付宝和国内访问的优势，完全可以接受。

相关教程 ​