1. 概览
AI 接口对接平台面向大模型应用场景，提供统一的 AI 服务转发与管理能力。开发者可通过同一套鉴权方式和接口规范调用平台已接入的对话、图片、视频与音频模型，降低多厂商接入成本。
- 对话
baseUrl：https://token.soar.qjclouds.cn/laserStreamEr/00000000/v1 - OpenAI 兼容协议
completionsPath：/chat/completions - 媒体
baseUrl：https://token.soar.qjclouds.cn/laserEr/00000000/v1 - 视频生成
completionsPath：/video/generations/{apiType} - 视频查询
completionsPath：/video/resource-actions/{apiType} - 音频生成
completionsPath：/audio/generations/{apiType} - 音频查询
completionsPath：/audio/resource-actions/{apiType} - 模型调用 API Key：由平台控制台生成，请妥善保管。
地址拼接示例：{baseUrl}{completionsPath}，即 https://token.soar.qjclouds.cn/laserStreamEr/00000000/v1/chat/completions。
2. 鉴权方式
所有接口请求均需在 HTTP Header 中携带 API Key：
| Header | 必填 | 说明 |
|---|---|---|
Authorization |
是 | Bearer <api_key> |
Content-Type |
是 | application/json |
Accept |
流式建议 | 流式设 text/event-stream;非流式可设 application/json |
说明：请不要将 api_key 写入前端代码、公开仓库或日志；服务端调用时建议使用安全的配置管理方式注入。
3. 通用错误码说明
| HTTP 状态码 | 说明 | 处理建议 |
|---|---|---|
400 |
请求体为空、JSON 非法或参数缺失。 | 检查请求格式、必填字段与字段类型。 |
401 |
未携带 API Key 或 API Key 无效。 | 检查 Authorization 请求头及密钥状态。 |
404 |
模型、路由或接口不存在。 | 确认模型编码和请求路径。 |
429 |
触发限流或配额不足。 | 退避重试，并检查额度或并发配置。 |
500 |
服务端或下游模型异常。 | 记录请求 ID 后稍后重试；持续出现请联系平台支持。 |
4. 客户端 API Key 接入手册
可按所使用的客户端查看在线文档或下载操作手册：