如何获取大模型 API Key:覆盖所有供应商与第三方集成的完整教程
更新日期:2026 年 11 月
如果你想用大模型做开发——无论是写自己的代码、配置 IDE 编程助手,还是使用无代码工具(如笔记应用 Obsidian 或 OneNote 插件 HydroMark)——第一步永远是同一件事:拿到一个 API Key。本教程带你走完所有主流第一方供应商、企业云平台、让你"一个 Key 调多个模型"的第三方聚合平台,以及如何把 Key 接入热门工具和框架的完整流程。

1. 什么是 API Key,它如何工作
API Key 是一个秘密令牌,同时承担三重角色:
- 身份证 — 向供应商的服务器证明你的应用身份。
- 万能钥匙 — 解锁你要调用的模型。
- 信用卡 — 你消耗的每一个 token 都计入 Key 所属账户的账单。
机制上非常简单:每个请求在 HTTP 头里携带这个 Key(通常是 Authorization: Bearer <key>),服务器校验 Key、检查配额、运行模型,并把用量记录到你的余额上。Key 错误或余额耗尽时,你会立刻收到 401 Unauthorized 或 429 Rate Limit Exceeded。
开始之前,有两个事实必须知道:
- Key 只显示一次。 几乎所有供应商都只在创建时完整显示一次密钥。请立即把它复制到密码管理器或
.env文件里。 - 计费与注册是两回事。 多数供应商要求先绑定支付方式或充值预付费额度,API 才能用——即使聊天应用本身是免费的。
2. 第一方供应商:国际平台
2.1 OpenAI(GPT 系列)
控制台: https://platform.openai.com
步骤:
- 注册账号并验证邮箱/手机号。
- 进入 Settings → API Keys → Create new secret key,选择项目和权限(受限权限的 Key 比全权限 Key 更安全)。
- 复制密钥(
sk-proj-...)——只显示一次。 - 进入 Billing → Add payment method,购买额度(最低约 5 美元)。未激活计费前,API 会直接报错。
说明: OpenAI 采用分级制度(Free → Tier 5),由充值额度和历史用量解锁更高级别,等级越高限速越宽松,且能使用更新的模型。
Base URL:
https://api.openai.com/v1
官方文档: OpenAI API docs
2.2 Anthropic(Claude 系列)
- 控制台: console.anthropic.com
- 步骤:
- 注册并验证账号。
- 进入 Settings → API Keys → Create Key,给 Key 起一个描述性名字(例如
myapp-production)。 - 复制密钥(
sk-ant-...)——只显示一次。 - 进入 Billing 购买预付费额度;累积一定用量后也可开通后付费。
- 说明: Claude 模型使用 Messages API,官方提供 Python、TypeScript、Java、Go SDK。
- Base URL:
https://api.anthropic.com
官方文档: Anthropic docs
2.3 Google(Gemini 系列)
Google 提供两条路径:
| 路径 | 适用人群 | 费用 |
|---|---|---|
| Google AI Studio(aistudio.google.com) | 个人开发者 | 有真正的免费层(有限速;免费层数据可能被用于训练) |
| Vertex AI | 使用 GCP 的企业 | 按量付费,你的数据不会被用于训练 |
- AI Studio 步骤(新手推荐):
- 访问 aistudio.google.com/apikey,用 Google 账号登录。
- 点击 Create API key——选择已有的 Google Cloud 项目,或让它自动新建一个。
- 复制密钥(
AIza...,39 个字符)。无需绑定信用卡即可开始。
- 说明: 以
AQ.Ab8...开头的字符串是 Gemini CLI 的 OAuth token,不是 API Key——不能用于直接 API 调用。 - Base URL:
https://generativelanguage.googleapis.com
官方文档: Gemini API docs
2.4 xAI(Grok 系列)
- 控制台: console.x.ai
- 步骤: 用 X(推特)账号登录 → API Keys → Create key → 立即复制 → 在 Billing 中绑定支付方式。
- Base URL:
https://api.x.ai/v1(兼容 OpenAI 格式)
官方文档: xAI docs
2.5 Mistral AI
- 控制台: console.mistral.ai(La Plateforme / Studio)
- 步骤: 注册账号 → 选择套餐(有免费实验模式,有用量和限速,无需信用卡)→ API Keys → Create new key → 可选设置过期时间 → 复制一次。
- Base URL:
https://api.mistral.ai/v1
官方文档: Mistral docs
2.6 Cohere
- 控制台: dashboard.cohere.com
- 步骤: 注册 → API Keys → Create key。试用 Key 免费但有限速;生产 Key 需要绑定计费。
- Base URL:
https://api.cohere.com
官方文档: Cohere docs
2.7 DeepSeek(全球单一平台)
- 控制台: platform.deepseek.com
- 步骤: 注册——国际用户可用邮箱注册 → API Keys → Create new API key → 复制 → Top Up 充值(约 2 美元起)。
- 说明: 与其他国内厂商不同,DeepSeek 只运营一个官方 API 平台同时服务中国和国际用户——没有单独的海外控制台或端点。所有官方 API 流量都跑在中国境内基础设施上;如果这是合规顾虑,其开源权重模型也可通过 Together、Fireworks、DeepInfra 或 OpenRouter 在海外基础设施上调用。
- Base URL:
https://api.deepseek.com(兼容 OpenAI 格式);Anthropic 兼容端点:https://api.deepseek.com/anthropic——可直接给 Claude Code 等工具当后端
官方文档: DeepSeek API docs
2.8 阿里云通义千问 — Model Studio 国际版(DashScope Intl)
- 控制台: 阿里云国际版账号 → Model Studio(与中国站是两个独立阿里云账号)
- 步骤: 在阿里云国际站注册 → 打开 Model Studio → API-KEY management → Create → 复制。
- Base URL:
https://dashscope-intl.aliyuncs.com/compatible-mode/v1(兼容 OpenAI 格式)
官方文档: Alibaba Cloud Model Studio Intl docs
2.9 字节跳动 — BytePlus ModelArk(豆包 / Seed 系列)
- 控制台: console.bytepluses.com(BytePlus 是字节跳动的海外品牌;与火山引擎是独立账号)
- 步骤: 注册 → 打开 ModelArk → 开通模型端点 → 生成 API Key。
- Base URL:
https://ark.ap-southeast.bytepluses.com/api/v3(兼容 OpenAI 格式)
官方文档: BytePlus ModelArk docs
2.10 月之暗面 — Kimi 国际版
- 控制台: platform.moonshot.ai(与 platform.moonshot.cn 是独立账号;美元计费)
- 步骤: 注册 → API Keys → Create → 复制 → 以美元充值。
- Base URL:
https://api.moonshot.ai/v1(兼容 OpenAI 格式);Anthropic 兼容端点:https://api.moonshot.ai/anthropic
官方文档: Kimi international API docs
2.11 智谱 AI — Z.ai(GLM 系列)
- 控制台: z.ai(与国内 BigModel 平台是独立账号;美元计费)
- 步骤: 注册 → API Keys → Create → 复制 → 选择按量付费或预付费套餐。
- Base URL:
https://api.z.ai/api/paas/v4(兼容 OpenAI 格式);Anthropic 兼容端点:https://api.z.ai/api/anthropic——支持 Claude Code 和 20+ 编程工具
官方文档: Z.ai docs
2.12 MiniMax 国际版
- 控制台: platform.minimax.io(与 platform.minimaxi.com 是独立账号;美元计费)
- 步骤: 注册 → API Keys → Create → 复制 → 充值。
- Base URL:
https://api.minimax.io/v1(兼容 OpenAI 格式);Anthropic 兼容端点:https://api.minimax.io/anthropic
官方文档: MiniMax international docs
2.13 硅基流动国际版(SiliconFlow International)
- 控制台: siliconflow.com(与 siliconflow.cn 是独立账号)
- 步骤: 注册 → API Keys → Create → 复制。新账号赠送免费额度;聚合大量开源模型(DeepSeek、Qwen、GLM 等)。
- Base URL:
https://api.siliconflow.com/v1(兼容 OpenAI 格式)
官方文档: SiliconFlow international docs
2.14 百度文心、腾讯混元、讯飞星火、百川(国际情况)
以上几家目前都没有自服务的国际 API Key 申请页面。百度和腾讯通过 Baidu AI Cloud International 和 Tencent Cloud International 接入国际客户(控制台账号与国内平台相互独立)。讯飞星火和百川目前只有国内 API 平台——国际接入需要联系其商务/销售团队,无法自助注册。
官方文档: Baidu Qianfan docs官方文档: Tencent Hunyuan docs官方文档: iFlytek Spark docs官方文档: Baichuan docs
2.15 小米 MiMo(全球单一平台)
- 控制台: platform.xiaomimimo.com(可在浏览器直接体验模型:aistudio.xiaomimimo.com)
- 步骤: 注册 → API Keys → Create New Key → 立即复制(只显示一次)。新账号有少量试用额度。
- 说明: 与 DeepSeek 类似,小米只用一个平台服务全球——按量付费没有单独的国内/国际控制台。两种使用方式:
- 按量付费 MiMo API(
sk-...密钥):按 token 计费。 - Token Plan 订阅(个人
tp-.../ 团队ttp-...密钥):固定月费 + 专属地域端点——中国https://token-plan-cn.xiaomimimo.com/v1、新加坡https://token-plan-sgp.xiaomimimo.com/v1、欧洲https://token-plan-ams.xiaomimimo.com/v1(集群选择影响延迟)。
- 按量付费 MiMo API(
- Base URL:
https://api.xiaomimimo.com/v1(兼容 OpenAI 格式);Anthropic 兼容端点:https://api.xiaomimimo.com/anthropic——支持 Claude Code。模型 ID 如mimo-v2.6-pro/mimo-v2.6-flash。
官方文档: Xiaomi MiMo docs
2.16 阶跃星辰国际站(StepFun International)
- 控制台: platform.stepfun.ai(与 platform.stepfun.com 是独立账号;美元计费)
- 步骤: 注册 → 接口密钥(platform.stepfun.ai/interface-key)→ Create API Key → 立即复制。国际站的实名要求与国内站不同,以控制台当前政策为准。
- 说明: 国际站延续国内站的计费通道设计:按量付费 API Key 与 Step Plan Oversea 订阅并存。两条通道使用不同端点,选错通道不会自动改用订阅额度。
- 按量付费(OpenAI 兼容):
https://api.stepfun.ai/v1 - Step Plan Oversea(OpenAI 兼容路径):
https://api.stepfun.ai/step_plan/v1 - Step Plan Oversea(Anthropic 兼容路径,用于 Claude Code):
https://api.stepfun.ai/step_plan
- 按量付费(OpenAI 兼容):
- 数据/合规: 国际站适用独立的隐私政策,数据处理和存储位于中国大陆境外——发送敏感代码或客户数据前请先核实。
2.17 Meta(Muse 系列)
- 控制台: dev.meta.ai(Meta Model API——目前为公开预览)
- 步骤: 用邮箱/手机号或 Facebook/Google/GitHub 注册 → 绑定支付方式(未绑定无法发请求)→ API keys → Create API key → 立即复制(只显示一次;官方示例从
MODEL_API_KEY环境变量读取)。 - 说明:
- 闭源旗舰模型:
muse-spark-1.3(新项目推荐;音频任务建议用muse-spark-1.2)与muse-wonder-1.0。推理无法关闭——用reasoning_effort(minimal / low / medium / high / xhigh / max)调节强度。 - 两档计费:Standard(不拿你的提示词训练;输入 $1.25 / 输出 $4.25 每百万 token)与 Contributor(便宜 90% 以上,但 Meta 会用你的提示词和补全训练模型——绝不要发机密数据)。新账号一次性赠送 $20 额度;付费限额为每分钟 3,000 请求 / 400 万 token。
- 开源权重兄弟版本:Muse Spark Open(816B,自定义 Muse Model License)与 Muse Glimmer 30B(Apache 2.0)——见 6.3 节。
- 限制地区(Meta 名单,2026 年 9 月更新)包括中国大陆、香港、澳门、俄罗斯、伊朗、朝鲜等。
- 闭源旗舰模型:
- Base URL:
https://api.meta.ai/v1 - 数据/合规: API 属公开预览,无变更通知承诺——投入预算前先复核价格与模型可用性。
官方文档: Meta Model API 文档
为什么重要: 2.7–2.17 的所有平台与第 3 章的国内平台是两套独立系统——控制台、账号、端点各不相同,Key 不能跨站使用。请根据你所在的位置和结算货币来选择。
官方文档: StepFun international docs
3. 第一方供应商:国内平台
本章覆盖国内平台——适合人在中国、以人民币结算、追求最低延迟的用户。这些平台要求实名认证,且大多兼容 OpenAI 格式,可以作为 OpenAI 的直接替代品。
⚠️ 下列每家厂商同时还运营一个独立的国际平台,拥有自己的账号体系和美元计费(见 2.7–2.17 节)。Key 不能跨站使用。(DeepSeek 和小米 MiMo 是服务全球的单一平台例外;讯飞星火和百川目前完全没有国际平台。)
国内平台速查表:
| 供应商 | 国内控制台 | 国内 Base URL(OpenAI 兼容) |
|---|---|---|
| DeepSeek | platform.deepseek.com | api.deepseek.com |
| 阿里云百炼(通义千问) | bailian.console.aliyun.com | dashscope.aliyuncs.com/compatible-mode/v1 |
| 字节火山方舟 | console.volcengine.com/ark | ark.cn-beijing.volces.com/api/v3 |
| 月之暗面(Kimi) | platform.moonshot.cn | api.moonshot.cn/v1 |
| 智谱 GLM(BigModel) | open.bigmodel.cn | open.bigmodel.cn/api/paas/v4 |
| MiniMax | platform.minimaxi.com | api.minimaxi.com/v1 |
| 阶跃星辰(Step) | platform.stepfun.com | api.stepfun.com/v1 |
| 讯飞星火 | console.xfyun.cn(星火大模型服务) | spark-api-open.xf-yun.com/v1 |
| 百川智能 | platform.baichuan-ai.com | api.baichuan-ai.com/v1 |
| 百度文心(千帆) | 千帆控制台 | qianfan.baidubce.com/v2 |
| 腾讯混元 | 腾讯云控制台 | api.hunyuan.cloud.tencent.com/v1 |
| 小米 MiMo | platform.xiaomimimo.com | api.xiaomimimo.com/v1 |
| 华为云(盘古/MaaS) | 华为云控制台 → ModelArts Studio | api.modelarts-maas.com/openai/v1 |
| 硅基流动 | siliconflow.cn | api.siliconflow.cn/v1 |
| 中国电信(TeleChat) | teleai.com.cn | api-maas.teleai.com.cn/v1 |
| 中国移动(九天) | ecloud.10086.cn → MoMA | zhenze-huhehaote.cmecloud.cn/v1(按地域) |
| 中国联通(元景) | maas.ai-yuanjing.com | maas-api.ai-yuanjing.com/openapi/compatible-mode/v1 |
各厂商详情如下。
3.1 DeepSeek
- 控制台: platform.deepseek.com(与聊天应用 chat.deepseek.com 是两个独立站点)
- 步骤: 注册(一般用 +86 手机号)→ API Keys → Create new API key → 复制 → Top Up 充值(约 2 美元 / 10 元起)。
- 说明: 完全兼容 OpenAI 格式,另有 Anthropic 兼容端点
https://api.deepseek.com/anthropic,可直接给 Claude Code 等工具当后端。
官方文档: DeepSeek API docs
3.2 阿里云通义千问(百炼 / Model Studio / DashScope)
- 控制台: bailian.console.aliyun.com(中国账号,需实名认证)
- 步骤:
- 注册并开通百炼。
- 打开 API Key 页面,先选好地域——每个地域有独立的端点、Key 和模型列表,不能跨地域混用。
- 点击创建 API Key,选择归属账号/业务空间,配置权限(支持 IP 白名单和模型白名单)。
- 复制 Key——只显示一次。
- 说明: 新账号通常有较大额的免费 token 体验金。Base URL:
https://dashscope.aliyuncs.com/compatible-mode/v1。
官方文档: Alibaba Model Studio docs
3.3 字节跳动火山引擎(豆包 / Seed 系列)
- 控制台: console.volcengine.com/ark → API Key 管理
- 步骤: 注册火山引擎账号 → 实名认证 → 创建推理接入点或使用默认 → 生成 API Key。
- Base URL:
https://ark.cn-beijing.volces.com/api/v3
官方文档: Volcano Ark docs
3.4 月之暗面(Kimi)
- 控制台: platform.moonshot.cn
- 步骤: 注册 → API Keys → 创建 → 复制 → 以人民币充值。
- Base URL:
https://api.moonshot.cn/v1;Anthropic 兼容端点:https://api.moonshot.cn/anthropic
官方文档: Moonshot Kimi docs
3.5 智谱 AI(GLM 系列,BigModel)
- 控制台: open.bigmodel.cn
- 步骤: 注册 → API Keys → 创建 → 复制 → 实名认证可提升限额。
- Base URL:
https://open.bigmodel.cn/api/paas/v4;Anthropic 兼容端点(供 Claude Code 等编程工具使用):https://open.bigmodel.cn/api/anthropic
官方文档: Zhipu BigModel docs
3.6 MiniMax
- 控制台: platform.minimaxi.com
- 步骤: 注册 → API Keys → Create new key → 复制 → 充值。
- Base URL:
https://api.minimaxi.com/v1;Anthropic 兼容端点:https://api.minimaxi.com/anthropic
官方文档: MiniMax docs
3.7 百度文心与腾讯混元
两者均通过各自的国内云控制台获取(百度千帆、腾讯混元 Cloud API / OpenAPI)。流程是标准套路:注册云账号 → 实名认证 → 开通模型服务 → 在控制台创建 API Key。腾讯混元端点为 https://api.hunyuan.cloud.tencent.com/v1(兼容 OpenAI 格式)。
官方文档: Baidu Qianfan docs官方文档: Tencent Hunyuan docs
3.8 小米 MiMo
- 控制台: platform.xiaomimimo.com——注意这是服务全球的单一平台(没有单独的国际控制台;Token Plan 的地域集群见 2.15 节)
- 步骤: 注册 → API Keys → Create New Key → 立即复制(只显示一次)。模型 ID 如
mimo-v2.6-pro/mimo-v2.6-flash。 - Base URL:
https://api.xiaomimimo.com/v1(兼容 OpenAI 格式);Anthropic 兼容端点:https://api.xiaomimimo.com/anthropic
官方文档: Xiaomi MiMo docs
3.9 华为云 — ModelArts Studio MaaS(盘古)
华为的模型服务通过华为云 ModelArts Studio(MaaS)提供——这是一个云上模型托管平台,既承载华为自研的盘古系列(openPangu-2.0-Pro/Flash),也在昇腾基础设施上提供主流开源模型(DeepSeek、GLM、Kimi K2.6、Qwen3)。
- 控制台: 华为云控制台 → ModelArts Studio → 模型即服务(MaaS)
- 步骤: 注册华为云账号 → 实名认证 → 打开 ModelArts Studio → 在模型广场开通所需模型 → 进入该模型的 API 调用详情页 → 创建 API Key → 立即复制(只显示一次)。
- Base URL(OpenAI 兼容):
https://api.modelarts-maas.com/openai/v1——目前 OpenAI 兼容端点只服务贵州地域;香港站点使用区域主机,如https://api-ap-southeast-1.modelarts-maas.com/openai/v1。模型、API Key 和端点必须属于同一地域——请始终从控制台的调用详情页复制准确 URL。 - 说明: 模型 ID 使用简洁命名(
openpangu-2.0-pro、glm-5.3、kimi-k2.6、deepseek-v4.1-flash、qwen3-32b)。企业 VPC/专属实例使用私有网关地址。
官方文档: Huawei Cloud ModelArts Studio MaaS docs
3.10 硅基流动(开源模型托管)
如果你想用一个国内平台同时调用多种开源模型(DeepSeek、Qwen、GLM 等),值得把它加进清单:
- 控制台: siliconflow.cn
- Base URL:
https://api.siliconflow.cn/v1 - 新账号赠送免费额度;兼容 OpenAI 格式。
官方文档: SiliconFlow docs
3.11 三大运营商(中国移动 / 中国电信 / 中国联通)
三家运营商都有自研大模型和自助 API 平台,托管在各自的云上。主要面向企业/政府客户,所以预期是实名认证 + 先购买套餐的流程,而不是免费试用额度。
| 运营商 | 模型 | 云 | 控制台 / 平台 | OpenAI 兼容 Base URL |
|---|---|---|---|---|
| 中国电信 | TeleChat(星辰) | 天翼云(CTYun) | teleai.com.cn(天翼 AI 开放平台);星辰 MaaS 在天翼云控制台 | https://api-maas.teleai.com.cn/v1 |
| 中国移动 | 九天(JiTian) | 移动云(ECloud) | ecloud.10086.cn → 九天 AI → MoMA 模型服务平台 | https://<region>.cmecloud.cn/v1(按地域,如 zhenze-huhehaote.cmecloud.cn/v1) |
| 中国联通 | 元景(YuanJing) | 联通云(CUCloud) | maas.ai-yuanjing.com(元景 MaaS 平台) | https://maas-api.ai-yuanjing.com/openapi/compatible-mode/v1 |
- 中国电信: 天翼 AI 开放平台流程为实名认证 → 购买套餐 → 创建应用 → 调用 API,凭证为
AppID+AppKey。使用 OpenAI 兼容的 MaaS 端点时,在星辰 MaaS 控制台创建密钥(系统管理 → API Key)。模型 ID 如TeleChat3-438B-A24B、Xing4.0-29B-A4B;官方文档显示该端点可在 Claude Code 等编程工具中使用。星辰 TokenHub 网关(https://ai.ctaigw.cn/v1,国际:https://ai.ctaigw.com/{region})覆盖全球区域(amer/eu/as)。 - 中国移动: 注册移动云 → 实名认证 → 打开 MoMA 控制台 → 模型广场 → 选择模型 → API 调用 → 获取 API Key。注意 API 地址按地域划分(如
https://zhenze-huhehaote.cmecloud.cn/v1/chat/completions)——请始终从控制台为你部署的模型复制准确 URL。可在 Chatbox、Cherry Studio、Dify 中使用。 - 中国联通: 在元景 MaaS 平台注册 → 工具箱 → API Key 管理 → 创建 → 复制。使用上表的 OpenAI 兼容地址(在会自动拼接
/chat/completions的工具中不要手动追加)。对 AI 编程工具,联通云还提供 Token Plan 订阅(cucloud.cn/product/tokenplan.html),订阅后从控制台下发专属 API Key + Base URL。
对多数开发者来说这些是小众选择——选它们的理由主要是数据主权要求、运营商云采购或捆绑套餐——但它们都是功能完整的 OpenAI 兼容端点。
官方文档: China Telecom Tianyi AI官方文档: China Mobile ECloud官方文档: China Unicom YuanJing
3.12 阶跃星辰(Step 系列)
- 控制台: platform.stepfun.com(国际版:platform.stepfun.ai)
- 步骤:
- 国内手机号直接注册(无需代理)。
- 完成实名认证——免费套餐用户和所有付费用户均需(用户中心 → 账户管理 → 账户信息;支付宝扫码人脸识别)。
- 控制台左侧导航 账户管理 → 接口密钥(platform.stepfun.com/interface-key)→ 创建 API Key → 复制保存(只显示一次)。
- 说明: 新用户赠送免费 token。Step Plan 订阅额外提供 Anthropic 兼容端点
https://api.stepfun.com/step_plan——Claude Code 等工具把ANTHROPIC_BASE_URL设为该地址即可(不带/v1;客户端会自动拼接/v1/messages)。 - Base URL:
https://api.stepfun.com/v1(兼容 OpenAI 格式)
官方文档: StepFun docs
3.13 讯飞星火(Spark)
- 控制台: console.xfyun.cn(讯飞开放平台 → 星火大模型服务)
- 步骤:
- 注册并认证 → 在控制台创建应用。
- 关键一步:打开"星火大模型"服务页面,为该应用开通模型版本(Lite / Pro / Max / 4.0Ultra)——漏掉这步会一直授权失败。
- 复制应用的 APIPassword。
- 说明(最大的坑): OpenAI 兼容端点用 APIPassword 认证,不是 APIKey 或 APISecret——那两个属于旧的 WebSocket 接口,填了会一直报 401。Lite 版本免费,适合先跑通再升级 Pro/Max/4.0Ultra。
- Base URL:
https://spark-api-open.xf-yun.com/v1(兼容 OpenAI 格式,结尾/v1不能少) - 国际服务: 无——星火没有自服务海外平台,国际接入需走讯飞商务渠道。
官方文档: iFlytek Spark docs
3.14 百川智能(Baichuan)
- 控制台: platform.baichuan-ai.com → API Key 管理
- 步骤: 注册 → 在 API Key 页面创建并复制 → 实名认证和充值。
- Base URL:
https://api.baichuan-ai.com/v1(兼容 OpenAI 格式) - 国际服务: 无——目前仅国内平台;海外接入需联系厂商商务。
官方文档: Baichuan docs
3.15 其他值得关注的
昆仑万维天工、商汤日日新(SenseNova)、零一万物(Yi 系列)也提供 OpenAI 兼容 API,流程都是同一套路:注册 → 实名认证 → 控制台创建 Key。具体入口和端点以各家官方文档为准。
官方文档: Kunlun Tiangong官方文档: SenseTime SenseNova官方文档: 01.AI
4. 企业云平台
如果你的组织已经在用某家超大规模云服务商,模型访问走的是云平台而非模型厂商的控制台。此时凭证按云平台方式管理,不是简单的 API Key。
4.1 Azure OpenAI(微软)
- 在你的 Azure 订阅中申请开通 Azure OpenAI 权限。
- 在 Azure Portal 中创建 Azure OpenAI Resource。
- 部署模型(Model deployments → 例如部署一个 GPT 模型)。
- 在资源概览的 Keys and Endpoint 中获取密钥和端点。
- 调用
https://<your-resource>.openai.azure.com/openai/deployments/<deployment>/chat/completions?api-version=...
官方文档: Azure OpenAI docs
4.2 AWS Bedrock
- 在 AWS 控制台打开 Amazon Bedrock。
- 在 Bedrock configurations → Model access 中开通模型访问权限(逐个申请各厂商的模型)。
- 没有针对单个模型的 API Key——使用标准 AWS 凭证(Access Key + Secret Key,或 IAM 角色),通常通过 AWS SDK 或
boto3客户端调用。
官方文档: Amazon Bedrock docs
4.3 Google Vertex AI
- 创建/选择 GCP 项目,启用 Vertex AI API。
- 用
gcloud auth application-default login或服务账号密钥 JSON 完成认证。 - 通过
https://<region>-aiplatform.googleapis.com/...和 Google Cloud SDK 调用模型。
为什么要用这些? 企业级合规、数据驻留保障(你的数据不会用于训练)、VPC 集成和统一账单。代价:比普通 API Key 的配置流程复杂得多。
官方文档: Vertex AI generative AI docs
5. 第三方聚合与推理平台
这类平台的共同卖点是:一次注册、一张账单、一套集成——往往覆盖数百个模型。
5.1 OpenRouter——一个 Key,数百个模型
- 控制台: openrouter.ai → Settings → Keys
- 步骤: 注册 → 创建 Key → 复制 → 可选充值。
- 说明: 最流行的聚合平台,兼容 OpenAI 格式,Base URL 为
https://openrouter.ai/api/v1。模型按厂商/模型命名(例如anthropic/claude-sonnet-5、deepseek/deepseek-chat)。带:free标签的路由完全免费,但每日额度较少——充入少量余额可以提升免费路由的限额。
官方文档: OpenRouter docs
5.2 Groq——超高速推理
- 控制台: console.groq.com → API Keys
- 步骤: 注册(免费层无需信用卡)→ 创建 Key → 复制。
- Base URL:
https://api.groq.com/openai/v1(兼容 OpenAI 格式)。以极高速度提供 Llama 等开源模型;注意每分钟限额较紧。
官方文档: Groq docs
5.3 Together AI
- 控制台: console.together.xyz → Settings → API Keys
- Base URL:
https://api.together.xyz/v1。提供开源模型、无服务器端点和微调服务。
官方文档: Together AI docs
5.4 Fireworks AI
- 控制台: fireworks.ai → 注册 → API Keys
- Base URL:
https://api.fireworks.ai/inference/v1。以快速服务开源模型著称,包括多模态模型。
官方文档: Fireworks AI docs
5.5 Cerebras Cloud
- 控制台: cloud.cerebras.ai → API Keys
- 步骤: 邮箱注册,无排队、免费额度无需信用卡 → 生成密钥(
csk-...)。 - Base URL:
https://api.cerebras.ai/v1。晶圆级推理——业界最快的 token 生成速度之一。
官方文档: Cerebras inference docs
5.6 GitHub Models
- 入口: GitHub Marketplace → Models(或 github.com 上的 Models playground)
- 步骤: 用 GitHub 账号登录 → 接受条款 → 按当前 GitHub Models 文档创建细粒度个人访问令牌(PAT)。
- 说明: 免费、有限速地访问一系列前沿模型,适合原型验证——如果你本来就重度使用 GitHub,这是最顺手的方案。
官方文档: GitHub Models docs
5.7 Cloudflare Workers AI
- 控制台: dash.cloudflare.com
- 步骤: 注册免费账号 → Workers AI → 创建具有 Workers AI 权限的 API token。
- 说明: 每日免费"neurons"配额;适合轻量级边缘部署。
官方文档: Cloudflare Workers AI docs
5.8 中转/网关服务
LinkModel、AiHubMix 等中转服务出售一个通吃多家官方供应商的 Key,价格有时低于官方。但在向任何第三方网关发送敏感数据之前,请务必核实其数据保留与合规政策。
5.9 NVIDIA NIM(build.nvidia.com)
NVIDIA 为自家 Nemotron 系列和庞大的开源模型目录(DeepSeek、Llama、Qwen、GLM、Kimi、Mistral、gpt-oss 等)提供托管推理——GPU 优化,OpenAI 兼容 API。
- 控制台: build.nvidia.com(加入免费的 NVIDIA Developer Program——只需邮箱,无需信用卡)
- 步骤: 创建账号 → 打开任意模型页或 Settings → API Keys → Generate API Key → 立即复制
nvapi-...密钥(只显示一次)。 - 说明: 免费层仅用于原型验证——有限速(多数模型约 40 RPM,无按 token 计费)。生产服务需要 NVIDIA AI Enterprise 许可证。相同的 NIM 容器可下载并在 NVIDIA GPU 上自托管,API 完全一致。
- Base URL:
https://integrate.api.nvidia.com/v1(兼容 OpenAI 格式;模型 ID 用厂商/模型格式,如nvidia/llama-3.3-nemotron-super-49b-v1.5)
官方文档: NVIDIA NIM docs
6. 没有公开 API 的产品:Copilot、Apple 等
不是所有大厂模型都能用一个普通 API Key 调用。这些是产品而非平台——下面说明它们是什么,以及该用什么替代。
6.1 Microsoft Copilot 与 GitHub Copilot
为什么没有 Key 可拿: Microsoft Copilot(Windows/Edge/365 Copilot)和 GitHub Copilot 是封闭的订阅制产品。微软不把其底层模型作为按量付费的公开 API 出售——你订阅的是产品,不是模型。
替代方案:
- Azure OpenAI / Azure AI Foundry(4.1 节)——微软官方的 GPT 模型 API 平台,带企业级合规。这才是你要找的"微软 API Key"。
- GitHub Models(5.6 节)——只用一个 GitHub 账号就能免费、有限速地试用模型目录。
- GitHub Copilot 订阅者还可以把某些开源编程工具指向 Copilot 支持的端点,但这是产品功能,不是通用 API。
官方文档: Microsoft 365 Copilot docs官方文档: GitHub Copilot docs
6.2 Apple Intelligence
为什么没有 Key 可拿: Apple 的模型(端侧模型和服务端 Private Cloud Compute 模型)只为 Apple 设备上的 Apple Intelligence 提供动力。Apple 不提供公开 LLM API、没有开发者 Key、没有按 token 计费——其服务端模型锁定在 Apple 硬件上,连自己的应用都无法直接调用。Apple 对外的 AI 集成是面向消费者的 ChatGPT 合作,而非开发者服务。
替代方案: 为 iOS/macOS 应用接入 AI,请通过你自己的后端调用本文列出的任意供应商(OpenAI、Gemini、Anthropic 都有官方 Swift SDK)。没有 Apple 托管的替代品。
官方文档: Apple Intelligence developer docs
6.3 Meta(Muse 开源权重)
Meta 现已为其 Muse 系列运营官方托管 API(见 2.17 节),但旗舰模型(Muse Spark、Muse Wonder)仍然闭源。家族中的开源权重部分:
- Muse Spark Open(2026 年 10 月):816B 参数的开源权重模型(激活 42B,100 万 token 上下文),采用自定义 Muse Model License——对多数用途免费,但年收入超过 2000 万美元的 API 转售商须与 Meta 另行签约。由 Together、Fireworks、Groq、Baseten、Modal、Nebius、OpenRouter 提供服务;权重可从 Hugging Face、SageMaker AI、Google Cloud Model Garden、Microsoft Foundry 下载。
- Muse Glimmer 30B(Apache 2.0):为本地 Agent 工作流打造的 30B 模型——用 Ollama、LM Studio、vLLM、llama.cpp 或 ExecuTorch 运行。无需 API Key,也没有按 token 费用。
这取代了此前"只有 Llama 权重"的局面:Meta 的模型线已迁移到 Muse 家族,开源权重发布与第一方 API 并存,而非互相替代。
官方文档: Meta Model API 文档
6.4 规律总结
一家公司"有大模型"不等于它卖 API 访问。要问的问题是:该厂商是否运营公开的、自助的、按 token 计费的端点? 如果没有,模型只能通过产品订阅(Copilot)、锁定硬件(Apple)或第三方托管开源权重(Ollama 跑 Muse Glimmer,或 Groq/NIM 上的开源模型)触达你。
7. 自托管与本地训练模型(OpenAI 兼容服务器)
Key 光谱的最后一站是根本没有 Key——或者说,Key 由你自己发明。现在所有主流本地运行时都暴露 OpenAI 兼容端点(/v1/chat/completions),这意味着你为云供应商写的同一套 OpenAI SDK、同一批工具、同一份代码,可以原封不动地对接跑在你自己 GPU 上的模型——包括你自己训练或微调的 checkpoint。
7.1 通用模式
from openai import OpenAI
client = OpenAI(
base_url="http://localhost:11434/v1", # 你的本地服务器
api_key="ollama", # 本地服务器不校验它,但 SDK 需要非空字符串
)
response = client.chat.completions.create(
model="qwen3:32b",
messages=[{"role": "user", "content": "Hello!"}],
)替换 Base URL 和模型名,这段代码就能对接下面任何运行时。在第三方工具(Chatbox、Cherry Studio、Cline、Dify 等)中,选择 "Ollama" 或 "OpenAI Compatible" 供应商,填本地 Base URL,Key 随便填一个占位符即可。
7.2 本地运行时对比
| 运行时 | 安装与启动 | Base URL | 典型用途 |
|---|---|---|---|
| Ollama | ollama pull qwen3:32b 然后 ollama serve | http://localhost:11434/v1 | 最易上手;模型库庞大;每个模型一条命令 |
| LM Studio | GUI 应用 → 下载模型 → Developer 页 → 启动服务器 | http://localhost:1234/v1 | 偏好图形界面的桌面用户;内置模型搜索 |
| vLLM | pip install vllm 然后 vllm serve <模型或checkpoint> --api-key sk-mysecret | http://localhost:8000/v1 | 生产环境 / 服务你自己训练的 checkpoint;高吞吐、连续批处理 |
| SGLang | pip install sglang 然后 python -m sglang.launch_server | http://localhost:30000/v1 | 高性能服务,结构化输出支持强 |
| llama.cpp | 编译后 llama-server -m model.gguf | http://localhost:8080/v1 | CPU/低资源机器,GGUF 量化模型 |
| Xinference / LocalAI | pip 安装 + 启动 | 见各自文档 | 在自有集群上多模型托管,原生 OpenAI 兼容 |
认证说明:Ollama 和 LM Studio 不校验 Key(任意非空值即可);vLLM 只有传入 --api-key 时才强制校验。如果把本地服务器暴露到 localhost 之外——局域网或公网——务必设置 API Key 并放到 HTTPS/反向代理之后,因为一个无鉴权的 OpenAI 端点和泄露的云 Key 一样危险。
7.3 训练或微调自己的模型,再用 OpenAI 方式提供服务
完全自主的全链路,端到端全部遵循 OpenAI 规范:
- 选基座模型——从 Hugging Face 或 ModelScope 下载开源权重(Qwen、GLM、Llama、DeepSeek、Mistral)。
- 微调——用 LoRA/QLoRA,主流工具:LLaMA-Factory(WebUI,零代码)、Unsloth(单卡、快)、Axolotl(配置驱动)。导出合并权重或适配器。
- 服务 checkpoint——把 vLLM(
vllm serve ./my-finetuned-model)或 SGLang 指向输出目录;或把 GGUF 包进 OllamaModelfile(FROM ./model.gguf→ollama create mymodel -f Modelfile)。 - 像 OpenAI 一样调用——
base_url指向你的服务器,model填你的 checkpoint 名。你的应用、工具和 Agent 框架完全分辨不出它与云 API 的区别。
这条路存在的意义: 零按 token 成本、完全数据隐私(什么都不离开你的机器)、无限速、对模型行为有完全控制权。代价是硬件成本、运维负担,以及你的微调与云端前沿模型之间的质量差距——对多数项目,最佳平衡是:用 vLLM 服务一个针对窄任务微调的中小型开源模型,重推理交给云 API。
8. 速查表
国际第一方
| 供应商 | 控制台地址 | 密钥前缀 | 免费层 | Base URL |
|---|---|---|---|---|
| OpenAI | platform.openai.com | sk-proj-... | 无(需计费) | api.openai.com/v1 |
| Anthropic | console.anthropic.com | sk-ant-... | 无(需充值) | api.anthropic.com |
| Google AI Studio | aistudio.google.com/apikey | AIza... | 有(有限速) | generativelanguage.googleapis.com |
| xAI | console.x.ai | xai-... | 有限 | api.x.ai/v1 |
| Mistral | console.mistral.ai | 视情况 | 免费实验模式 | api.mistral.ai/v1 |
| Cohere | dashboard.cohere.com | 视情况 | 试用 Key | api.cohere.com |
| Meta(Muse) | dev.meta.ai | MODEL_API_KEY | $20 一次性额度 | api.meta.ai/v1 |
国内第一方(国内平台见第 3 章;国际平台见 2.7–2.17 节)
| 供应商 | 国内控制台 / Base URL | 国际控制台 / Base URL |
|---|---|---|
| DeepSeek | platform.deepseek.com · api.deepseek.com | 同一平台(无独立国际端点) |
| 阿里通义千问 | bailian.console.aliyun.com · dashscope.aliyuncs.com/compatible-mode/v1 | 阿里国际 Model Studio · dashscope-intl.aliyuncs.com/compatible-mode/v1 |
| 火山方舟(豆包) | console.volcengine.com/ark · ark.cn-beijing.volces.com/api/v3 | BytePlus ModelArk · ark.ap-southeast.bytepluses.com/api/v3 |
| 月之暗面(Kimi) | platform.moonshot.cn · api.moonshot.cn/v1 | platform.moonshot.ai · api.moonshot.ai/v1 |
| 智谱 GLM | open.bigmodel.cn · open.bigmodel.cn/api/paas/v4 | z.ai · api.z.ai/api/paas/v4 |
| MiniMax | platform.minimaxi.com · api.minimaxi.com/v1 | platform.minimax.io · api.minimax.io/v1 |
| 阶跃星辰(Step) | platform.stepfun.com · api.stepfun.com/v1 | platform.stepfun.ai · api.stepfun.ai/v1 |
| 讯飞星火 | console.xfyun.cn · spark-api-open.xf-yun.com/v1 | 无(仅商务渠道) |
| 百川智能 | platform.baichuan-ai.com · api.baichuan-ai.com/v1 | 无(仅商务渠道) |
| 百度文心 | 千帆控制台 · qianfan.baidubce.com/v2 | 经 Baidu AI Cloud International 接入 |
| 腾讯混元 | 腾讯云控制台 · api.hunyuan.cloud.tencent.com/v1 | 经 Tencent Cloud International 接入 |
| 小米 MiMo | platform.xiaomimimo.com · api.xiaomimimo.com/v1 | 同一平台(Token Plan 集群:cn/sgp/ams 子域) |
⚠️ Key 与平台绑定: 国内平台的 Key(.cn 域名、人民币计费)无法调用国际端点,国际 Key 也无法调用国内端点。两套账号体系不共享余额或密钥。
聚合平台
| 供应商 | 控制台地址 | Base URL | 特点 |
|---|---|---|---|
| OpenRouter | openrouter.ai/settings/keys | openrouter.ai/api/v1 | 数百个模型、:free 免费路由 |
| Groq | console.groq.com/keys | api.groq.com/openai/v1 | 免费层、速度极快 |
| Together | console.together.xyz | api.together.xyz/v1 | 开源模型 + 微调 |
| Fireworks | fireworks.ai | api.fireworks.ai/inference/v1 | 快速开源模型服务 |
| Cerebras | cloud.cerebras.ai | api.cerebras.ai/v1 | 免费层、极速 |
| GitHub Models | github.com marketplace | Azure 兼容 | GitHub 账号免费使用 |
| Cloudflare Workers AI | dash.cloudflare.com | REST/bindings | 每日免费 neurons |
| NVIDIA NIM | build.nvidia.com | integrate.api.nvidia.com/v1 | 免费原型验证、Nemotron + 开源模型 |
9. 在工具与框架中使用你的 API Key
9.1 通用模式:环境变量
所有工具和 SDK 都能从环境变量读取密钥。设置一次即可:
# macOS / Linux —— 追加到 ~/.bashrc 或 ~/.zshrc
export OPENAI_API_KEY="sk-proj-..."
export ANTHROPIC_API_KEY="sk-ant-..."
export GEMINI_API_KEY="AIza..."
export DEEPSEEK_API_KEY="sk-..."# Windows PowerShell(永久)
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-proj-...", "User")多 Key 项目建议使用 .env 文件配合 python-dotenv 或 dotenv——并且在第一次提交之前就把 .env 加进 .gitignore。
9.2 第一个 API 调用(可直接复制)
curl https://api.openai.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-d '{
"model": "gpt-4o",
"messages": [{"role": "user", "content": "Hello!"}]
}'由于 DeepSeek、Moonshot、智谱、Groq、Together、OpenRouter 等大多数平台都兼容 OpenAI 格式,同一段代码随处可用——只需替换 Base URL 和模型名:
from openai import OpenAI
client = OpenAI(
api_key=os.environ["DEEPSEEK_API_KEY"],
base_url="https://api.deepseek.com",
)
response = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)# 通过官方 SDK 调用 Gemini
from google import genai
client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
print(client.models.generate_content(
model="gemini-2.5-flash", contents="Hello!"
).text)9.3 热门工具的密钥配置位置
| 工具 | 配置位置 |
|---|---|
| Cursor | Settings → Models → 添加供应商 + API Key |
| Claude Code | ANTHROPIC_API_KEY 环境变量;通过 ANTHROPIC_BASE_URL 指向兼容 OpenAI 格式的后端 |
| Cline / Roo Code / Continue(VS Code) | 插件设置 → 供应商下拉框 → 粘贴 Key;"OpenAI Compatible" 选项支持自定义 Base URL |
| Chatbox / Cherry Studio / LobeChat | 设置 → 模型供应商 → 粘贴 API Key + Base URL + 模型名 |
| Dify | 设置 → 模型供应商 → 选择厂商 → 粘贴 Key |
| n8n / Langflow / Flowise | Credentials 区域 → 为供应商创建凭证 → 粘贴 Key |
| 接入 Ollama 的前端 | 本地模型无需 Key;远程供应商按上述方式添加 |
9.4 框架集成
# LangChain
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(model="gpt-4o", api_key=os.environ["OPENAI_API_KEY"])
from langchain_anthropic import ChatAnthropic
claude = ChatAnthropic(model="claude-sonnet-5", api_key=os.environ["ANTHROPIC_API_KEY"])// OpenAI Node SDK
import OpenAI from "openai";
const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });一个 Base URL 通吃的技巧: 如果某个兼容 OpenAI 的工具只允许你选择 OpenAI 作为供应商,把 Base URL 设为聚合平台(如 https://openrouter.ai/api/v1),模型名用 google/gemini-2.5-flash 这类格式——一个 Key 就能调用该工具能触达的所有模型。
10. 免费方案对比
| 方案 | 真免费? | 限制 |
|---|---|---|
| Google AI Studio | 是,有限速的免费层 | 免费层数据可能被用于训练 |
| Groq / Cerebras 免费层 | 是,每日额度慷慨 | 每分钟限额紧,仅开源模型 |
| Mistral 免费/实验模式 | 是 | 有用量和限速 |
OpenRouter :free 路由 | 是 | 每日请求次数少 |
| GitHub Models | 是 | 有限速,仅适合原型验证 |
| Cloudflare Workers AI | 每日免费配额 | 模型较小 |
| NVIDIA NIM(build.nvidia.com) | 免费原型层 | 有限速(约 40 RPM);生产需 AI Enterprise 许可证 |
| DeepSeek 及其他 | 仅按量付费 | 非常便宜但非免费(新账号可能有一笔一次性赠送) |
11. API Key 安全:7 条不能省的规则
一个泄露的 Key 意味着余额被刷光,最坏情况是五位数的账单。以下规则没有商量余地:
- 绝不硬编码密钥。 使用
.env文件、环境变量或密钥管理服务(Vault、AWS Secrets Manager、Doppler)。绝不要把 Key 粘贴进客户端或移动端代码——被人提取滥用易如反掌。 - 绝不把 Key 提交到 Git。 先把
.env写进.gitignore。一旦 Key 进了提交历史,立即轮换——即使是私有仓库也一样。 - 第一时间设置消费上限。 在每个供应商后台配置月度限额或仅预付费模式。你被泄露的最大损失应该是那个上限,而不是账户里的全部余额。
- 每个项目/环境一个 Key。 开发、预发布、生产环境分开建 Key,泄露的开发 Key 影响不到生产配额,轮换也不疼不痒。
- 能用就限制 Key 权限。 OpenAI 的项目级 Key、百炼的 IP/模型白名单、Azure 的策略约束都能缩小爆炸半径。
- 每 3–6 个月轮换一次——任何疑似泄露后更是立刻换。
- 每周查看用量日志。 用量异常飙升是 Key 被盗用的典型信号。先吊销,再排查。
生产应用务必通过自己的后端代理转发所有模型流量,让终端用户永远接触不到任何 Key;供应商支持短时令牌的要优先使用(例如百炼的临时 Key,最长 1800 秒)。
12. 常见报错排查
| 报错 | 可能原因 | 解决方法 |
|---|---|---|
401 Unauthorized | Key 错误、已被吊销,或请求头格式不对 | 重新复制 Key;确认格式为 Authorization: Bearer <key> |
429 Rate Limit Exceeded | 等级太低或瞬时超限 | 增加带指数退避的重试;充值提升等级 |
insufficient_quota / 余额类报错 | 未开通计费或额度耗尽 | 在控制台绑定支付方式或充值 |
model not found | 该供应商/Base URL 下模型 ID 不对 | 查阅供应商模型列表;聚合平台用 厂商/模型 格式 |
| curl 能通、工具里报错 | Base URL 错误或地域不匹配(百炼各地域不能混用) | 核对所属地域的准确 compatible-mode 端点 |
国内厂商 Key 在另一端点报 401 | Key 建在国内平台却指向了国际 Base URL(或反之)——两者是独立账号体系 | 让 Key 与端点配对:moonshot.cn ↔ moonshot.cn 控制台,z.ai ↔ z.ai 控制台,依此类推(见第 8 章对照表) |
Gemini 密钥是 AQ.Ab8... 开头 | 那是 CLI 的 OAuth token,不是 API Key | 从 aistudio.google.com/apikey 重新生成 |
13. 重要:信息失效了怎么办
大模型 API 领域变化极快——控制台会改版、端点会迁移、免费层会随时出现和消失、厂商会合并平台、整个产品线会被砍掉。如果本文的某个方法与你在控制台里看到的不再一致,或者失效了,不要以为供应商倒闭了——大概率只是流程变了。
遇到这种情况,通过以下任一渠道刷新信息:
- 问 AI 助手——ChatGPT、Claude、Gemini、Kimi、豆包、DeepSeek,或你日常使用的任何助手。提问要具体,例如:"2026 年怎么拿 Z.ai 的 API Key?旧的步骤和控制台对不上了。" 现代助手能联网搜索,通常能给出当前的控制台路径、价格和注册流程。
- 搜索引擎——搜索厂商名加
API key、价格等关键词或当前年份(例如 "DeepSeek API key 2026")。优先选择厂商官方域名(platform.xxx.com、docs.xxx.com、帮助中心)的结果,第三方博客过期得更快。 - 厂商自己的文档和公告页——多数控制台都有"更新日志 / What's new"或文档首页,端点迁移之前都会先公告。
- 开发者社区——你在用的工具的 GitHub issues/discussions(Cline、Chatbox、OpenRouter 等)、Stack Overflow、Reddit(r/LocalLLaMA)、V2EX,以及厂商自己的社媒渠道(X、微信公众号、微博、即刻)——破坏性变更几乎总在几小时内被报告。
两个省时间的习惯:把每家厂商的官方文档首页加书签,控制台改版就不会把你困住;照做任何教程前先看日期——没有日期的指南往往落后三个控制台版本。
总结
所有平台的流程完全一致:注册账号 → 打开供应商控制台 → 创建 Key → 立即复制 → 开通计费(除非有免费层)→ 存入环境变量。 Google AI Studio 是最好的真正免费起点;DeepSeek 和国内平台是最低价的按量付费选择;OpenRouter 之类的聚合平台让你彻底告别多控制台来回切换。对国内厂商,最常见的错误是注册错了平台:国内和国际的控制台、账号、端点是独立系统,所以创建 Key 之前先根据你的位置和结算货币做决定(见第 3 章对照表)。当连一个云 Key 都嫌多余时,一台自托管的 Ollama/vLLM 服务器——服务你自己微调的 checkpoint——说着和 OpenAI 一模一样的"方言"。此后,同一个 OpenAI 兼容请求格式可以服务本清单上几乎每一家供应商——这正是为什么一个妥善保管的 Key(或一个聚合 Key,或一个 localhost 地址)通常就能满足整个项目的需求。
API Key、控制台和免费层变动频繁。生产使用前请以供应商官方文档为准核实细节。


