API 介绍

Sonaops Open API 采用 API Key + 请求签名 的认证方式，所有业务接口统一使用 POST 方法。

接口列表

接口路径	说明
POST /v1/chat/conversation	创建会话
POST /v1/chat/stream	流式聊天（SSE）
POST /v1/chat/image	聊天图片生成
POST /v1/chat/tts	语音播报
POST /v1/live/list	直播列表
POST /v1/live/detail	直播详情
POST /v1/image/upload	上传参考图
POST /v1/image/generate	自定义生图

通用响应格式

所有接口成功时返回统一 JSON 结构：

{
  "code": 10200,
  "success": true,
  "message": "OK",
  "data": { ... },
  "traceId": "9fU0kfWy3E8YFGjS5S8bLPlAXG8xhdTH",
  "timestamp": "1773298769366"
}

业务错误以 HTTP 200 返回，通过 success: false 区分：

{
  "code": 40000,
  "success": false,
  "message": "错误描述"
}

HTTP 错误码

状态码	说明
401	认证失败：缺少请求头、时间戳过期、API Key 无效或签名错误
400	请求参数缺失或格式错误
404	资源不存在
500	服务端内部错误