API 参考、版本与弃用

Nodaryx API 与 OpenAI 兼容:把任意 OpenAI SDK 指向我们的基址,用 Nodaryx API 密钥鉴权即可。

OpenAPI 规范

下载机器可读的规范,导入 Postman、Insomnia 或代码生成器:

• 下载 OpenAPI 规范(OpenAPI 3.0,JSON)

它描述了公开端点 —— POST /chat/completions 与 GET /models —— 及其请求/响应结构和 bearer 令牌鉴权方式。

基址:  https://api.moyuncourse.site/v1
鉴权:  Authorization: Bearer sk-nodaryx-...

API 版本

稳定的主版本是 v1,它包含在基址路径中(/v1/...)。我们不会在 v1 上原地做破坏性变更。破坏性变更会以新的主版本发布,旧版本在迁移窗口内继续可用。

非破坏性的增量变更(新增可选字段、新增模型、新增端点)可能随时进入 v1 —— 你的集成照常工作。

变更公告

每一项面向用户的变更都会发布在更新日志,每个破坏性变更都附带迁移说明。关注更新日志以提前掌握变化。

弃用策略

• 端点 / 字段:v1 中被弃用的部分会在更新日志公告,给出替代方案与移除日期;在此之前继续可用。
• 模型:模型在下架前可被标记为弃用。你会在控制台与模型列表看到标记,以便在移除前迁移到替代模型。