从零接入大模型 API

入门 · 8 分钟阅读 · 更新于 2026-09-03

如果你已经会发 HTTP 请求，接入大模型 API 并不复杂。真正需要做好的，是把 Key、超时和错误处理放在第一天就考虑进去。

1. 准备 API Key

把 Key 放进环境变量，不要直接写进前端代码或提交到 Git：

export OPENAI_API_KEY="你的 API Key"

2. 发出第一条请求

API 中转站通常提供 OpenAI 兼容接口，只需要替换 base_url，原有 SDK 代码就能继续使用：

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["OPENAI_API_KEY"],
    base_url="https://api.clawsocket.com/v1",
)

response = client.chat.completions.create(
    model="gpt-5",
    messages=[{"role": "user", "content": "用一句话解释 API 中转站"}],
)
print(response.choices[0].message.content)

3. 上线前检查

• 设置 30 秒以上的读取超时，并对 429、500 做指数退避。
• 在服务端记录请求耗时、token 用量和模型名，但不要记录完整用户隐私内容。
• 给不同环境使用不同 Key，方便撤销和追踪。

需要一个统一入口来切换模型？查看 API 方案 →