Nous Research Portal 免费模型额度怎么领：聚合网关申请与调用指南

Portal 提供 OpenAI 兼容接口，所以已有的 OpenAI SDK 或脚本基本只需要换 base_url、api_key 和 model 三处。接口地址的形态是控制台文档页给出的域名再加 /v1，对话补全的路径为 /v1/chat/completions；请直接从控制台「API 文档 / Quickstart」页复制完整地址，不要自己拼域名。

第一步：写入环境变量

把控制台复制的接口地址、Key，以及模型目录里复制的模型 ID 存进环境变量，避免硬编码在代码里。

export NOUS_BASE_URL="在这里粘贴控制台文档页给出的接口地址"
export NOUS_API_KEY="在这里粘贴控制台创建的 API Key"
export NOUS_MODEL="在这里粘贴模型目录中复制的模型 ID"

第二步：发一次对话补全请求

下面的 curl 直接复用上面的变量，可以原样复制运行。注意 JSON 里的引号必须保持 ASCII 直引号。

curl "$NOUS_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $NOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"$NOUS_MODEL\",
    \"messages\": [
      {\"role\": \"system\", \"content\": \"你是一个简洁的中文助手。\"},
      {\"role\": \"user\", \"content\": \"用三句话介绍你自己。\"}
    ],
    \"temperature\": 0.7,
    \"max_tokens\": 512,
    \"stream\": false
  }"

关键参数说明

• model：必填，必须填模型目录中可复制的 ID，而不是页面上展示的营销名称；标价 $0.00/1M 的条目才是免费档位。
• messages：必填，数组，按顺序排列，role 取 system、user、assistant，content 为文本。
• temperature：可选，0 到 2，写代码类任务建议 0.2 到 0.4，闲聊可高一些。
• max_tokens：可选但建议显式设置，用来控制单次回复上限，避免长输出把额度吃光。
• stream：设为 true 时返回 SSE 流式分片，适合前端打字机效果；调试阶段建议先设 false 便于看清报错。
• tools：需要函数调用时传入，注意工具调用与云托管走 credits 计费，不属于免费额度范围。

额度耗尽与限流的典型表现

• 401 Unauthorized：Key 错误、被吊销或带了多余空格，重新复制或新建 Key。
• 402 或余额不足提示：当前请求落在了付费模型或 credits 已用尽，换回 $0 清单里的模型。
• 404 model not found：模型 ID 拼错，或该模型已从当期免费清单下架，回目录页重新确认。
• 429 Too Many Requests：触发速率限制，查看响应头里的重试等待时间，降低并发或加重试退避。
• 请求超时或空回复：多为 max_tokens 过小或网络问题，先把 stream 关掉复现一次。

排查顺序建议固定为：先核对模型是否还在免费清单，再核对 base_url 与路径是否拼对，然后验证 Key 是否有效，最后才看限流与余额。免费档位会轮换，把模型 ID 做成配置项而不是写死在代码里，换档时只改一个环境变量即可。