从第一次调用开始。
使用统一 API，连接已配置的模型服务，并自动将调用归入对应项目。
快速开始
- 由管理员开通账户，并在管理后台配置真实上游 Base URL、API Key 和模型名称。
- 登录控制台，在“项目管理”创建项目。
- 在“API 密钥”选择项目并生成密钥，立即保存明文。
- 将开发工具的 Base URL 设置为
https://sl.shanksit.com/v1，API Key 设置为项目密钥。模型使用管理员配置的真实模型 ID。
接口调用
下面的 MODEL_ID 替换为实际模型 ID；YOUR_PROJECT_API_KEY 替换为刚创建的项目密钥。可先调用 GET /v1/models 查看可用模型。
curl https://sl.shanksit.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_PROJECT_API_KEY" \
-H "Content-Type: application/json" \
-H "X-Workload-Stage: development" \
-d '{
"model": "MODEL_ID",
"messages": [{"role": "user", "content": "请审核这段代码的边界条件"}],
"max_tokens": 1024,
"stream": false
}'返回标准模型响应。响应头 X-Leiyu-Request-ID 为本平台请求编号；控制台同时保存上游返回的请求编号，便于核对。
为研发阶段打标签
调用时通过 X-Workload-Stage 请求头指定阶段。项目由密钥绑定，不能通过请求头改为其他项目。
| 阶段标签 | 工作内容 |
|---|---|
development | 代码开发 |
review | 代码审核 |
testing | 软件测试 |
aigc | AIGC 创作 |
other | 其他任务 |
省略阶段标签时使用 development。标签描述由调用方指定，平台不会自动验证具体研发任务是否完成。
计量与费用口径
输入、输出 Token 直接取自上游 JSON 响应的 usage.prompt_tokens 和 usage.completion_tokens。不使用字符数推算。上游不提供计量时，显示“未提供”，该次调用不计入 Token 总量与费用估算。
参考费用（元）=（输入 Token × 输入参考单价 + 输出 Token × 输出参考单价）÷ 1,000,000。单价单位为元 / 百万 Token，按调用时配置快照保存，不随之后的价格修改重算历史数据。
调用耗时为网关发起请求到收到上游响应的时间。图表、日期筛选及导出统一采用 Asia/Shanghai。调用记录不提供人工新增、修改或删除入口。平台不保存用户提示词和生成内容。
AIGC 文本创作
调用相同的文本模型接口，设置 X-Workload-Stage: aigc，即可归入创作阶段。当前支持文本内容生成；不支持图像、视频、音频生成或 GPU 实例生命周期管理。
兼容性与限制
网页采用服务器渲染和 ES5 语法，提供 IE11 所需的日期文本输入回退与传统布局。推荐使用最新版 Chrome 或 Edge；已验证的浏览器与部署信息见交付说明。IE11 仅作兼容设计，未在真实 IE 环境验收。
当前网关支持 OpenAI 兼容的非流式 chat/completions，以及 models 查询。暂不支持 SSE 流式输出、工具调用、文件上传、嵌入向量和多模型路由。max_tokens 为 1–16,384；单次请求体最多 256 KB；上游等待最多 120 秒；每密钥每分钟最多 60 次完成的调用。
400 表示参数无效，401 表示密钥无效或已撤销，429 表示请求过于频繁，503 表示尚未配置服务，502 表示上游连接或响应失败。请保留平台请求编号联系管理员。