学生、课程与低预算 Demo

用小预算，跑通你的第一个 Claude / GPT API Demo

NorthAPI Labs 面向学生、课程作业和个人 Demo：从查模型列表、发一条短请求，到把调用接进课堂演示。整个过程按最短路径走一遍，先确认能通，再决定要不要加量，不必一上来就担心把额度花光。

注册并完成第一次调用查看新手项目

建议顺序：注册并建 Key → 请求 /v1/models 查模型名 → 发一条短 prompt 验证 → 再接入课程或 Demo。

最短路径跑通第一个 Demo

查模型列表

注册并建好 Key 后，先请求 /v1/models 看看当前有哪些模型，把返回里的真实模型 ID 复制下来。不要凭印象手写模型名，可用模型以实际返回为准。

发一条短请求

用一句最短的 prompt 发一次 chat 请求，确认鉴权、地址和模型名都对。能正常返回，说明整条通路已经打通，可以继续往下。

接入课程作业或 Demo

通路验证过后，把这段调用接进课程作业、课堂演示或个人 Demo，从小规模开始，一点点加内容，边看效果边看消耗。

把预算关进笼子

学习阶段的额度不用很多，关键是别让一次失误把这周的预算花光。下面三件事在写第一行调用代码时就可以做好。

设置 max_tokens 上限

给每次请求设定 max_tokens，避免一次输出过长突然吃掉额度。学习和 Demo 阶段，几百 token 往往就够看清效果了。

少量样本先测

先拿三五条样本跑，确认 prompt 和模型选对了，再决定要不要扩大数量。不要一上来就整批提交，错了也是整批浪费。

记录每次消耗

留意每次调用的 token 和扣费，按作业或 Demo 分开建 Key，方便回头看这周花了多少、花在了哪个项目上。

课程项目里 Key 放哪

做课程 Demo 最常见的安全问题，是把 API Key 直接写进前端页面，或连同代码提交到公开仓库，结果被别人拿去刷额度。

正确的做法是把 Key 放在后端：前端只调用你自己的后端接口，由后端持有 Key 再转发请求到 NorthAPI Labs。提交代码前确认 Key 不在仓库里，用环境变量或 .env（并把它加进 .gitignore）来管理凭证。这一步比功能本身更值得在课堂上先讲清楚。

第一个请求示例

把下面两条命令里的 YOUR_API_KEY 换成自己的 Key，先查模型、再发一条带 max_tokens 的短请求即可。

# 第 1 步：查看当前可用模型
curl https://northapilabs.xyz/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

# 第 2 步：发一条最短请求（模型名从上一步复制）
curl https://northapilabs.xyz/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<从 /v1/models 复制>","max_tokens":200,"messages":[{"role":"user","content":"你好，用一句话介绍一下你自己"}]}'

额度与计费

¥1 = $1

充值 ¥1 到账 $1 API 额度。充值兑换率与调用倍率是分开的两件事，先看得懂再充值。

低价来源倍率：default 0.15x、Kiro Pro 0.15x、特惠 0.15x、GPT Team 0.15x。
官转档为独立计费分组（特惠来源），倍率 1.2x，不代表模型厂商官方服务。
调用扣费 = 模型基准价 × 来源倍率。
Claude 与 GPT 走现有分组，可用模型以 /v1/models 实际返回为准。
本站由 NorthAPI Labs 运营团队运营，是第三方兼容 API 服务，不是 Anthropic / OpenAI 或其他厂商官方服务。

符合最新活动资格的用户，累计前 ¥50 实付享 1:1 API 额度赠送，最多赠送 $50；超过部分及达到上限后的充值不再赠送。资格与口径以本站公告和后台核验为准。

常见问题

学生党没什么预算，能先小额试试吗？

可以。充值 ¥1 到账 $1 API 额度，先用短 prompt 和少量样本跑通，再决定是否加量。调用扣费 = 模型基准价 × 来源倍率，充值兑换率与调用倍率是分开的两件事。

第一次调用应该先做什么？

先注册并验证邮箱、创建一个 Key，再请求 /v1/models 查看当前可用模型，复制返回里的真实模型 ID，最后发一条短请求确认整条通路能返回。

做课程 Demo 时 API Key 放哪比较安全？

放后端。前端只调用你自己的后端，由后端持有 Key 再转发请求；不要把 Key 写进前端代码或提交到 Git 仓库，可用环境变量或 .env 管理并加入 .gitignore。

怎么避免学习阶段额度用超？

给请求设置 max_tokens 上限、先用少量样本测试、按作业分开建 Key 记录每次消耗；限制上下文和批量规模，学习和 Demo 阶段不需要大流量。

有 Claude 和 GPT 吗？NorthAPI Labs 是官方服务吗？

本站通过现有分组同时路由 Claude 与 GPT，实际可用模型以 /v1/models 的返回为准。本站是第三方兼容 API 服务，不是 Anthropic、OpenAI 或其他厂商官方服务。