对话管理/创建对话
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
aicontent:ModelRouterCreateConversation |
create |
*全部资源
|
无 | 无 |
请求语法
POST /api/v1/modelRouter/open/conversations HTTP/1.1
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
请求 body 参数。 |
|
| chatData |
string |
否 |
对话数据 JSON,包含各模型的消息记录(必填) |
{"stream":true,"messages":[{"role":"user","content":"1+1"}],"model":"qwen/qwen-max/r0","stream_options":{"include_usage":true}} |
| modelIds |
string |
否 |
模型 ID 列表,JSON 数组字符串 |
15 |
| title |
string |
否 |
对话标题,不传则自动从第一条用户消息提取 |
test |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
OpenApiSingleResponse |
{ "success": true, "data": {"id": 1, "title": "新对话"}, "requestId": "592A27EF-26D3-1434-98C1-97AD63337852" } |
|
| requestId |
string |
请求编号 |
xxxx-xxxx-xxxx-xxxxxxxx |
| success |
boolean |
是否成功 |
true |
| errCode |
string |
错误信息编码 |
UNKNOWN_ERROR |
| errMessage |
string |
错误信息 |
未知错误 |
| httpStatusCode |
integer |
http 状态码 |
200 |
| data | ConversationDTO |
数据对象 |
[] |
示例
正常返回示例
JSON格式
{
"requestId": "xxxx-xxxx-xxxx-xxxxxxxx",
"success": true,
"errCode": "UNKNOWN_ERROR",
"errMessage": "未知错误",
"httpStatusCode": 200,
"data": {
"id": 1,
"title": "我的对话",
"messageCount": 10,
"modelIds": "[1,2,3]",
"chatData": "{}",
"deleteTag": 0,
"gmtCreate": "2024-01-01T00:00:00Z",
"gmtModified": "2024-01-01T00:00:00Z"
}
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 500 | Server.Internal.UnknownError | The request processing has failed due to some unknown error. | |
| 403 | B.Permission.DeniedException | 鉴权失败或权限不足 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。