API 基础说明

Base URL 与认证

兼容 OpenAI 的客户端统一使用：

https://api.nuorand.com/v1

通过标准 Bearer 方式发送令牌：

Authorization: Bearer YOUR_API_KEY

获取模型列表

curl https://api.nuorand.com/v1/models \
  -H "Authorization: Bearer $JUTONEO_API_KEY"

模型 ID 区分大小写。请从模型目录复制准确 ID，不要自行猜测别名。

流式响应

在 Chat Completions 请求中设置 stream: true。网关会转发服务器发送事件（SSE），因此反向代理和应用客户端都不应等待整条响应完成后再一次性缓冲。

错误与重试

按 HTTP 状态码处理错误：

状态码	含义	建议操作
400	请求无效或参数不受支持	核对请求与所选模型
401	令牌缺失或无效	核对 Bearer Token
429	触发速率或额度限制	退避后加入随机延时重试
5xx	临时网关或供应商错误	有限次数重试幂等请求

不要无限重试。采用短周期指数退避，并在避免不必要保存敏感提示词的前提下保留请求日志。