新手第一次配置 API 的完整流程：从注册到跑通第一个请求

这篇写给第一次接触模型 API 的读者：不假设你有任何背景，跟着做就能跑通。

整体流程

拿到 API Key → 选好工具 → 填 Base URL + Key → 发第一个请求

全程 10 分钟以内。

第 1 步：拿到 Key

不管是官方渠道还是聚合网关，注册后都能在控制台找到「API Keys」页面，创建一个新 Key。它会以 sk- 开头，只显示一次，立刻复制保存。

安全习惯：Key 等同于钱包密码，不要发到群聊、不要提交到代码仓库。泄露了就立刻删除重建。

第 2 步：确认两个关键信息

在服务商文档里找到（一般都在首页显著位置）：

1. Base URL：接口地址，形如 https://api.xxx.com/v1
2. 可用模型名：这个端点能调哪些模型，准确 ID 是什么

第 3 步：发出第一个请求

方式 A：命令行验证（推荐先做这步）

用 curl 先验证链路，排除工具层问题：

curl https://你的BaseURL/chat/completions \
  -H "Authorization: Bearer sk-你的key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "模型名",
    "messages": [{"role": "user", "content": "你好，请用一句话自我介绍"}]
  }'

返回一段 JSON，里面有 content 字段就是成功了。

方式 B：Python

from openai import OpenAI

client = OpenAI(
    base_url="https://你的BaseURL/v1",
    api_key="sk-你的key",
)

resp = client.chat.completions.create(
    model="模型名",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

注意 Python SDK 的 base_url 要写到 /v1 这一层。

方式 C：图形界面客户端

不想写代码就用 Cherry Studio、Chatbox 这类桌面客户端，把 Base URL 和 Key 填进设置即可，参考我们的 Cherry Studio 配置教程。

第 4 步：看懂账单

API 按 token 计费，输入和输出分别计价。你的控制台会有消耗明细，重点看：

• 每次调用的 token 数：输入 + 输出
• 余额变动：对不上账时优先检查是不是有程序在循环调用

新手期建议：设置余额预警（大多数平台支持），充小金额试错。

常见第一次的坑

现象	原因	解决
401	Key 错 / 多了空格	重新复制
404	Base URL 路径不对	检查 /v1 层级
model not found	模型名拼错	用端点文档里的准确 ID
一直转圈超时	网络 / 端点故障	先用 curl 定位问题在哪一层

下一步

跑通第一个请求后，可以：

• 把端点接入 Cursor 或 Claude Code 等开发工具
• 通过接入咨询确认目标模型、预计用量和预算口径
• 阅读报错对照表，遇到问题不再慌

---

有疑问？联系我们