API 概览

使用 API Reference 查询 Moss API 的 endpoint、请求参数、返回值、流式事件和共享规则。业务接入建议先看场景指南；字段级实现以对应 Reference 页面为准。

鉴权

所有请求在请求头中带上 Bearer Token。把 Key 导出为环境变量，不要写进代码库。

curl "https://api.mosi.cn/v1/models" \
  -H "Authorization: Bearer $MOSS_API_KEY"

Endpoint	能力	同步	异步	流式
GET /v1/models	查询可用模型列表	✓	-	-
POST /v1/files	上传文件并获取 `file_id`	✓	-	-
GET /v1/files	查询文件列表	✓	-	-
GET /v1/files/{file_id}	查询文件详情	✓	-	-
DELETE /v1/files/{file_id}	删除文件	✓	-	-
POST /v1/audio/speech	单人文本转语音，支持非流式与流式	✓	✓	✓
POST /v1/audio/speech/speakers	多人对话语音生成	✓	✓	-
POST /v1/audio/transcriptions	音频转写	✓	✓	✓
GET /v1/audio/voices	查询音色列表	✓	-	-
POST /v1/audio/voices	创建音色	✓	-	-
POST /v1/audio/voice/generations	音色生成	✓	✓	-
POST /v1/responses	多模态理解	✓	-	-
WSS /v1/realtime	实时视频理解，WebSocket 双向事件（Beta）	-	-	✓
GET /v1/audio/tasks/{task_id}	查询任务	✓	-	-
POST /v1/images/generations	图像生成	✓	-	-

规则	说明
Base URL	`https://api.mosi.cn`
认证	所有请求通过 `Authorization: Bearer $MOSS_API_KEY` 鉴权。
JSON 请求	语音生成、音频转写 `file_id` / URL、多模态理解、图像生成等接口使用 `application/json`。
文件上传	本地文件上传使用 `multipart/form-data`，字段名按具体 endpoint 说明填写。
同步	请求保持连接，完成后直接返回结果。
异步	音频耗时任务可传 `async=true` 创建任务，再通过 `GET /v1/audio/tasks/{task_id}` 查询。
流式	HTTP 流式 endpoint 在请求参数中明确 `stream` 和返回格式；实时视频理解通过 WebSocket 双向事件交互，不是 SSE。
错误	同步错误使用平台通用错误结构；字段级错误以具体 endpoint 的请求参数说明为准。