提示：笔记源自于赋范空间“大模型Agent开发实战”，课程链接为：https://appze9inzwc2314.h5.xet.citv.cn/p/course/ecourse/course_37xx2DBh83EgnWSwQFYDOoBLPpS?type=3&sub_course_list_mode=0

一、全球AI模型版图与平台选型

  在全球大模型领域，三大头部厂商构成了技术创新的第一梯队。OpenAI 的 GPT 系列（GPT-5.2、GPT-5.2 Pro）在多模态理解和自主 Agent 能力上保持领先，Anthropic 的 Claude 系列（Claude 4.5 Sonnet/Opus）以最强代码能力和复杂推理著称，而 Google 的 Gemini 系列（Gemini 3.0 Pro）则在超长上下文（1M+ tokens）和原生多模态融合上有独特优势。

  但对于国内开发者，这些模型的访问门槛极高。OpenAI 和 Anthropic 不对中国大陆用户开放注册，即使通过技术手段访问，也面临需要海外手机号验证、海外信用卡支付等障碍。Google Gemini 虽然在部分地区可访问，但同样存在支付限制。更严重的是，这些限制不仅体现在注册环节，在 API 调用时也会进行 IP 检测和区域封锁。

  这种封锁并非技术问题，而是政策与商业策略的结果。因此，国内开发者需要在"技术先进性"和"可访问性"之间做出权衡——要么选择国产替代方案，要么通过中转平台间接访问。

1、OpenRouter突破封锁的中转平台

  对于确实需要使用 GPT-5.2 或 Claude 4.5 的场景，API 中转平台成为了国内开发者的"救命稻草"。其中最值得推荐的是 OpenRouter——一个聚合了 300+ 模型的 API 网关服务。但它绝不仅仅是"卖号的中转商"，而是在合规架构、商业利益和技术实现之间找到了微妙平衡的 “AI模型路由聚合器”。

  OpenRouter 的核心定位：去中心化的"算力券商"

  OpenRouter 的定位非常清晰：它不生产模型，而是像"券商"一样，左手连接各大模型厂商（OpenAI、Anthropic、Google、Qwen、DeepSeek），右手连接全球开发者。开发者只需要写一套代码（OpenAI 兼容格式），就可以随意切换后台模型。更聪明的是，它会自动帮你路由到当前价格最低或速度最快的供应商——因为同一个开源模型（如 Qwen2.5-72B）可能在 Together AI、Groq 或 Fireworks （推理服务商，直接调 API）上都有部署，OpenRouter 会帮你挑最优的。

• 与普通中转商的本质区别

特性	OpenRouter	普通中转商 / 壳站
稳定性	极高。正规企业运营，有 SLA 保障	低。多为"逆向工程"或"号池"轮询，随时跑路
模型来源	正规 Enterprise API，是 OpenAI/Anthropic 的企业级大客户	通常是普通账号池，甚至盗刷信用卡
隐私政策	透明。提供"Zero Retention"零留存选项	黑盒。你的数据极大概率被截获留存
支付方式	支持微信/支付宝/加密货币，无需外卡	微信转账，风险高，无保障

2、国内模型生态：性价比与可用性的平衡

  DeepSeek（深度求索） 是当前性价比最高的选择。其最新的 DeepSeek-V3.2 模型在数学推理、代码生成及工具调用（Thinking in Tool-Use）等任务上已对齐 GPT-5 水平，但 API 定价极为亲民。更重要的是，DeepSeek 提供了较为慷慨的免费额度，非常适合新手练习和小规模项目测试。api申请地址：https://platform.deepseek.com/api_keys

  阿里云的通义千问（Qwen）是企业级应用的优选。通过百炼平台（DashScope），可以访问 Qwen-Max 系列的文本、视觉（Qwen-VL）、音频（Qwen-Audio）等多模态模型。阿里云生态的优势在于与云资源的深度整合，以及完善的技术支持体系。api申请地址：https://bailian.console.aliyun.com/cn-beijing?tab=model#/model-market/all

  智谱 AI 的GLM系列则体现了学术背景的技术积累。基于清华大学研发的 GLM 架构，其在长文本理解和知识推理上有独特优势。GLM-Next 已支持超长上下文窗口，并通过开放平台提供了 OpenAI 兼容的 API 格式。api申请方式：进入https://open.bigmodel.cn ，点击右上角的"控制台"按钮即可进入注册或登录页面。智谱AI支持手机号、微信等多种登录方式，注册过程相对简单快捷。

  此外，还有月之暗面的 Moonshot、MiniMax 等多个可选平台。这些国产模型的共同特点是：无需翻墙、支持国内支付、提供免费额度、响应速度快。虽然在某些细分能力上与 GPT-5 仍有差距，但对于绝大多数应用场景已经完全够用。

4、模型选型决策

平台	访问门槛	技术能力	定价水平	免费额度	推荐场景
OpenAI GPT	⚠️ 极高（需海外卡+手机）	⭐⭐⭐⭐⭐ 最强	💰💰💰 贵	❌ 无	生产环境（海外）
Anthropic Claude	⚠️ 极高（同 OpenAI）	⭐⭐⭐⭐⭐ 代码最强	💰💰💰 贵	❌ 无	代码生成、复杂推理
OpenRouter	✅ 低（国内可注册）	⭐⭐⭐⭐⭐ 聚合全部	💰💰 中等（有加价）	⚠️ 部分模型免费	学习测试、多模型对比
DeepSeek	✅ 极低（手机号注册）	⭐⭐⭐⭐ 对齐 GPT-5	💰 极低	✅ 慷慨	学习、开发、小项目
阿里百炼	✅ 低（需实名认证）	⭐⭐⭐⭐ 多模态强	💰💰 中等	✅ 100万 Tokens	企业应用、多模态
智谱 GLM	✅ 低（手机号注册）	⭐⭐⭐ 长文本强	💰 低	✅ 2000万 Tokens	知识推理、长文本

二、获取并保存API KEY

这里以OpenRouter为例：

生成了api key之后要立即复制

在pycharm里中创建一个文档，命名为.env，将api key保存在该文档中，便于后续调用。

注意：OpenRouter需要先充值才能调用！
除了OpenRouter以外，deepseek和质谱的api key获取都是同样的道理。

三、调用API

1、非SDK方式调用

如果使用SDK方式来调用api的话，代码就会相对繁琐一些，需要pip install python-dotenv（pycharm终端）

import requests
from dotenv import load_dotenv
import os

load_dotenv(override=True)
api_key = os.getenv("DEEPSEEK_API_KEY")

response = requests.post(
    "https://api.deepseek.com/v1/chat/completions",
    headers={"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"},
    json={
        "model": "deepseek-chat",
        "messages": [{"role": "user", "content": "你好"}]
    }
)
print(response.json()['choices'][0]['message']['content'])

2、 OpenAI SDK方式调用

（1）什么是SDK？

SDK（Software Development Kit，软件开发工具包）。SDK 是对 API 的封装,让开发者不需要手写复杂的 HTTP 请求,而是用简洁的代码就能调用 API。

（2）具体调用方式

pip install openai

from openai import OpenAI
from dotenv import load_dotenv
import os

# 加载 .env 文件
load_dotenv(override=True)

# 从环境变量读取 API Key
api_key = os.getenv("DEEPSEEK_API_KEY")  # 确保你的 .env 里有这个变量

# 创建客户端（注意 base_url 的格式）
client = OpenAI(
    api_key=api_key,
    base_url="https://api.deepseek.com/v1"  # 去掉 /chat/completions
)

# 发送请求
response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "你好"}]
)

print("使用 SDK 的结果：", response.choices[0].message.content)

使用 SDK 的结果： 你好！很高兴见到你！😊 我是DeepSeek，由深度求索公司创造的AI助手。无论你有什么问题、需要什么帮助，或者只是想聊聊天，我都很乐意为你提供支持！

我可以帮你解答各种问题，协助处理文档，进行创作和分析等等。有什么我可以为你做的吗？我会尽我所能热情地帮助你！✨

  可以看到,SDK 帮我们处理了 HTTP 头部、JSON 序列化、错误处理等细节,让代码更简洁易读。openai 就是 OpenAI 官方提供的 Python SDK。

  在大模型 API 领域,一个有趣的现象是：几乎所有的平台都声称"兼容 OpenAI API 格式"。这意味着什么？

  OpenAI 在 2020 年发布 GPT-3 API 时,设计了一套简洁的调用接口。其核心是 chat.completions.create() 方法,接受 model（模型名称）和 messages（对话消息列表）两个必填参数。这个设计因其简洁性和扩展性,逐渐成为了行业事实标准。

  目前,DeepSeek、阿里百炼、智谱清言、OpenRouter 等平台都支持这套格式。这带来了巨大的便利性——我们只需要修改两个配置项,就能在不同平台之间无缝切换。