Novita AI 免费额度领取与 API 接入教程
免费额度
新账号赠 $0.5 体验金，部分模型有免费试用端点
注意事项
教程
Novita AI 是面向开发者的模型推理云平台，新账号可领取一次性体验金，用来验证从注册到发起第一次请求的完整链路。下面按控制台的实际入口顺序说明。
- 进入官网注册入口。打开
https://novita.ai/，在右上角找到登录/注册按钮，点击进入账号页。注册方式支持邮箱加密码，也支持第三方账号快捷登录；用工作邮箱更便于后续接收额度与账单通知。 - 完成邮箱验证。提交注册后到邮箱查收验证邮件并点击确认链接。若几分钟内没有收到，先检查垃圾邮件目录，再回到注册页重新发送；未验证的账号通常无法正常调用接口。
- 确认是否需要绑定支付方式。该平台的新账号赠送额度属于免绑卡即可体验的类型，先不需要填写信用卡即可进入控制台查看额度。后续如需充值或提升配额，再按控制台提示添加支付方式即可。
- 在控制台领取并核对额度。登录后进入账户的余额或账单页面，可看到赠送的体验金金额及入账记录，具体数额与币种以控制台实际显示为准。部分模型另设有免费试用端点，是否开放、单次限制多少同样以控制台或模型详情页的标注为准。
- 创建 API Key。在密钥管理页面新建一个密钥，命名时带上用途（例如测试环境），生成后立即复制保存。密钥只在创建时完整显示一次，页面关闭后无法再次查看。
- 留意有效期与常见坑。赠送额度通常有使用期限，过期未用完会失效，到期时间以控制台显示为准；额度按实际调用的 token 消耗扣减，不是按次发放。常见问题包括：密钥泄露后未及时删除、把密钥直接写进前端代码、以及误用高价模型快速消耗赠额，建议测试期只选用小参数模型。
拿到密钥后即可按 OpenAI 兼容方式调用。接口基地址为 https://api.novita.ai/v3/openai，在 OpenAI 官方 SDK 中把 base_url 指向该地址并填入 Novita 的密钥即可复用现有代码；具体路径以控制台文档页的说明为准。
模型名从哪里获取
模型标识不能凭记忆填写。请在控制台的模型列表页或模型文档中查看当前可用的模型 ID，例如常见的开源对话模型会以厂商加型号的形式命名。把模型 ID 原样复制到请求参数中，注意区分大小写与连字符。
用 curl 发起一次对话补全
先把密钥写入环境变量，避免在命令历史中留下明文：
export NOVITA_API_KEY="sk_你的密钥"然后发送一个最小请求，关键参数是 model（模型 ID）、messages（对话数组，含 role 与 content）、temperature（采样随机度，测试时可用 0.7）、max_tokens（回复长度上限，先设小值以免一次消耗过多额度）：
curl https://api.novita.ai/v3/openai/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $NOVITA_API_KEY" \
-d '{
"model": "你的模型ID",
"messages": [
{"role": "user", "content": "用一句话说明什么是模型推理"}
],
"temperature": 0.7,
"max_tokens": 128
}'返回体中的 choices[0].message.content 即模型输出，usage 字段给出本次消耗的输入与输出 token 数，可用于估算赠额还能支撑多少次调用。
额度耗尽与限流的典型表现
- 返回 401 或鉴权失败：密钥错误、已被删除，或请求头缺少
Bearer前缀。 - 返回 402 或余额不足提示：赠送额度已用完或已过期，需在控制台查看余额与到期时间后决定是否充值。
- 返回 429：触发速率限制或并发上限，表现为短时间内连续失败，降低请求频率或加指数退避重试通常能恢复。
- 返回 404 或模型不存在：模型 ID 拼写有误，或该模型已下线、当前账号无权访问，回到模型列表重新确认。
排查顺序
建议按这个顺序定位问题：先确认密钥有效且请求头格式正确，再核对 base_url 是否拼错或多了斜杠，接着确认模型 ID 与控制台一致，然后查看余额与限流状态，最后才怀疑网络与超时。测试阶段把 max_tokens 设小、先用小模型跑通链路，能显著降低试错成本。请勿把密钥写进浏览器端代码，也不要把赠额当作长期免费方案，正式上线前应评估实际调用成本。
这个还能用吗？点一下告诉我们
只能从下方固定选项中选择，无法自由输入，避免垃圾信息与安全隐患。
留言区 0
真实访客可自由留言，提交后先经内容安全审核（本地 + 可选远程 API）再展示；违规内容会被拦截，不会出现在此处。示例留言均带「示例」标识，不冒充真实用户。