KN CUBE
API DOCUMENTATION

开发文档

使用 KN CUBE 的 API 密钥和 Base URL,将模型接入服务端应用。

快速开始

登录工作台后,前往 API 密钥 创建并复制密钥。在服务端将它保存为环境变量 KN_CUBE_API_KEY。下文示例从该变量读取密钥。

Base URL加载中…

打开模型广场查看接口类型与费用。密钥所属分组、模型权限和账户额度会影响实际调用。

选择接入协议

你的应用是下游,向 KN CUBE 发送请求。KN CUBE 校验密钥并选择渠道,将请求转发给上游模型服务。客户端只需填写本站的地址与密钥。

OpenAI 兼容客户端
支持 Chat Completions 的模型使用 POST /v1/chat/completions。客户端的 Base URL 填写上方带 /v1 的完整地址。
Responses 与 Anthropic Messages
模型详情列出相应接口时,可使用 POST /v1/responses 或 POST /v1/messages。按所选协议构造原生请求体。
图像、向量及其他接口
打开模型详情核对该模型的路径和请求方式。不同类型的模型接受不同的输入。

查询可用模型

使用当前密钥请求 GET /v1/models。在响应的 data 数组中找到需要的 id。对话示例需选择支持 Chat Completions 的模型。

cURL

发送对话请求

填入选定的模型 ID,然后复制对应语言的示例。cURL 示例适用于 Bash。Python 和 JavaScript 示例使用 OpenAI SDK,JavaScript 文件可保存为 .mjs。

也可以直接在示例中替换 YOUR_MODEL_ID。

排查调用错误

401
认证失败

检查 Authorization 请求头和密钥状态。使用本站工作台签发的密钥。

403
权限或额度不足

在工作台核对账户余额、密钥额度和允许的模型。如果本站额度充足,保留响应头 X-Oneapi-Request-Id 中的请求编号,管理员可用它核对上游余额和分组权限。

404
模型或接口不可用

核对模型 ID 和请求路径,并重新查询当前密钥的模型列表。

429
达到速率或额度限制

先查看返回的错误信息。限速时降低并发,额度不足时检查所属分组和可用额度。

503
网关并发已满

当错误码为 gateway_busy 时,本次请求尚未转发。本站初始设置为同时接收 24 个推理连接。请按 Retry-After 至少等待 3 秒,再逐步延长重试间隔。已开始的流会继续传输。模型可用性还取决于上游服务。

5xx
服务或上游错误

在用量日志查找该次请求,保留返回的请求 ID 和错误信息,以便定位渠道问题。