大模型在线API接入基础入门一、全球AI模型版图与平台选型1、OpenRouter突破封锁的中转平台2、国内模型生态性价比与可用性的平衡4、模型选型决策二、获取并保存API KEY三、调用API1、非SDK方式调用2、 OpenAI SDK方式调用1什么是SDK2具体调用方式提示笔记源自于赋范空间“大模型Agent开发实战”课程链接为https://appze9inzwc2314.h5.xet.citv.cn/p/course/ecourse/course_37xx2DBh83EgnWSwQFYDOoBLPpS?type3sub_course_list_mode0一、全球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?tabmodel#/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获取都是同样的道理。三、调用API1、非SDK方式调用如果使用SDK方式来调用api的话代码就会相对繁琐一些需要pip install python-dotenvpycharm终端importrequestsfromdotenvimportload_dotenvimportos load_dotenv(overrideTrue)api_keyos.getenv(DEEPSEEK_API_KEY)responserequests.post(https://api.deepseek.com/v1/chat/completions,headers{Authorization:fBearer{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什么是SDKSDKSoftware Development Kit软件开发工具包。SDK 是对 API 的封装,让开发者不需要手写复杂的 HTTP 请求,而是用简洁的代码就能调用 API。2具体调用方式pip install openaifromopenaiimportOpenAIfromdotenvimportload_dotenvimportos# 加载 .env 文件load_dotenv(overrideTrue)# 从环境变量读取 API Keyapi_keyos.getenv(DEEPSEEK_API_KEY)# 确保你的 .env 里有这个变量# 创建客户端注意 base_url 的格式clientOpenAI(api_keyapi_key,base_urlhttps://api.deepseek.com/v1# 去掉 /chat/completions)# 发送请求responseclient.chat.completions.create(modeldeepseek-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 等平台都支持这套格式。这带来了巨大的便利性——我们只需要修改两个配置项,就能在不同平台之间无缝切换。