大模型 API 接入教程:从注册到调用
面向新手 · OpenAI 兼容协议 · 10 分钟跑通第一个请求
核心思路:几乎所有主流大模型(OpenAI、DeepSeek、Qwen、GLM、Gemini 等)都兼容 OpenAI 接口规范。你只需要 一个 API Key + 一个 base_url,就能用同一套代码切换不同模型。本文以最常见的 Python / Node 为例。
四步接入流程
- 注册并领取免费额度。在厂商控制台注册账号,进入 API 页面创建密钥(Key)。优先选提供免费额度的平台,详见 免费额度汇总。
- 确认接口地址。OpenAI 官方为
https://api.openai.com/v1;第三方兼容平台(如硅基流动、DeepSeek)会提供各自的base_url,在文档中查找。 - 安装 SDK 并发请求。Python 用官方
openai包;Node 用openai或原生 fetch。只需改base_url与api_key即可切换模型。 - 上线前做成本控制。开启提示词缓存、限制最大 token、监控用量,避免意外超额。可用本站「Token 价格计算器」预估花费。
Python 调用示例(OpenAI 兼容)
from openai import OpenAI
client = OpenAI(
base_url = "https://api.your-provider.com/v1", # 替换为你的服务商地址
api_key = "YOUR_API_KEY"
)
resp = client.chat.completions.create(
model = "deepseek-chat", # 替换为目标模型名
messages = [{"role":"user","content":"用一句话解释什么是大模型"}]
)
print(resp.choices[0].message.content)
Node.js 调用示例
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.your-provider.com/v1",
apiKey: "YOUR_API_KEY"
});
const resp = await client.chat.completions.create({
model: "deepseek-chat",
messages: [{ role: "user", content: "用一句话解释什么是大模型" }]
});
console.log(resp.choices[0].message.content);
省钱与避坑
- 优先用免费层验证链路,再按量付费。
- 批量/缓存请求可降本 30%–70%。
- 生产环境务必设置超时、重试与配额告警。
- 不要把 Key 写进前端代码或公开仓库,使用环境变量存储。
常见问题
新手如何获取大模型 API Key?
在厂商控制台注册并创建密钥,多数平台提供免费额度,可先领后用。
OpenAI 兼容接口怎么调用?
把请求发到各家的 /v1/chat/completions,请求头带 Authorization: Bearer <KEY>,替换 base_url 与 api_key 即可。
调用报错 401 / 429 怎么办?
401 重新生成 Key;429 降低并发或切换免费层/更换模型。
如何控制 API 成本?
用免费层与按量计费、开启缓存、用 Token 价格计算器估算,详见免费额度页。
本地能跑大模型吗?
能。Ollama、vLLM 可在本地部署开源模型,适合隐私与离线场景。