零基础个人开发者:从拿 key 到第一次成功返回的最短路径
面向从未使用过 LLM API 聚合站的个人开发者,提供从注册、充值到成功调用第一个模型的最短路径指南。重点讲解如何选择低成本模型、构造最小请求体、用最少花费验证调用,并给出常见错误的排查思路。
第一次接触 LLM API 聚合站,可能会被“模型列表”“计费倍率”等概念吓到。但你的目标很简单:用最少的步骤和成本,让一段代码成功返回一句 AI 回复。下面就是最短路径。
第一步:注册并获取 API Key
聚合站通常不需要 KYC,用邮箱注册即可。登录后,在控制台找到“API Keys”或类似入口,创建一个新 Key。
- 复制 Key 并保存到安全的地方(例如密码管理器)。
- Key 只显示一次,丢失只能重新生成。
第二步:用 USDC 充值(Base 网络)
聚合站支持用 Base 网络上的 USDC 充值。
- 在控制台找到“充值”或“Billing”页面。
- 复制你的专属充值地址(或二维码)。
- 从交易所或钱包向该地址发送 USDC(务必选择 Base 网络,其他网络可能导致资产丢失)。
- 等待几分钟,余额会自动到账。
注意:充值金额没有最低限制,但建议先充最小可感金额,足够测试即可。
第三步:选择最便宜的模型
你的第一次调用不需要最强的模型。为了验证流程,优先选择单价低、响应快的模型。
- 在模型列表里,找标注为“轻量”“快速”或“经济”的模型,例如 DeepSeek、Qwen、GLM 的入门版本。
- 避免一开始就用 Claude Opus 或 GPT-4 这类高倍率模型。
聚合站通常按“官方价 × 倍率”扣费,你的调用费用 = 官方价格 × 1.3。选便宜模型能进一步压低测试成本。
第四步:构造最小请求体
大部分聚合站兼容 OpenAI 的 Chat Completions 格式。你只需要一个最小的 JSON:
{
"model": "你想用的模型ID",
"messages": [
{"role": "user", "content": "Hello"}
]
}
model填模型列表里看到的准确 ID(区分大小写)。messages里只放一条用户消息,内容越短越好。- 不要加
temperature、max_tokens等可选参数,减少出错概率。
第五步:发送请求(以 curl 为例)
假设你的 API 基础地址是 https://api.example.com/v1(请替换为聚合站实际提供的地址)。
curl https://api.example.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 你的API_KEY" \
-d '{
"model": "模型ID",
"messages": [{"role": "user", "content": "Hello"}]
}'
如果一切正常,你会收到类似这样的响应:
{
"choices": [
{
"message": {
"role": "assistant",
"content": "Hello! How can I help you?"
}
}
]
}
看到 content 字段里的文字,就说明调用成功了。
第六步:验证与排查
如果没返回预期结果,按以下顺序检查:
- 401 错误:API Key 错误或没放在
Authorization头里。检查是否多了空格、少了Bearer。 - 404 错误:请求地址不对。确认聚合站文档里的完整 URL。
- 400 错误:请求体格式问题。检查 JSON 是否合法、
modelID 是否存在。 - 余额不足:去控制台确认 USDC 是否到账。
- 超时:换一个更轻量的模型重试。
关于成本:你付多少,贡献者返多少
聚合站采用统一倍率:
- 作为用户,你按官方价 × 1.3 扣费。
- 如果你贡献自己的 API Key,按官方价 × 1.1 返 USDC(优质 Key 可到 × 1.2)。
这意味着你不需要预付大额资金,也没有隐藏费用。第一次调用建议只充最小金额,跑通后再按需充值。
下一步
成功返回第一条消息后,你可以:
- 尝试在请求里加入
stream: true,体验流式输出。 - 换一个稍强的模型,对比回答质量。
- 把 curl 换成 Python 或 Node.js 的 OpenAI SDK,把
base_url指向聚合站地址即可。
整个过程的核心就是:注册 → 充 USDC → 选便宜模型 → 发最小请求 → 看回复。走通一次,后面就只是换模型和加参数的事了。