发送对话消息

POST

/chat/messages

发送用户问题，返回 AI 回答。支持两种返回模式：

stream=false（默认）：HTTP 一次性返回 {chat_id, complete_response, message_id}

stream=true：返回 SSE 流，事件类型 status / message_id / token / done / error

chat_id 不传则自动创建新对话。

file_list 最多 10 个 file_key。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

{
    "chat_id": 123,
    "query": "请帮我总结这份文档",
    "file_list": [
        "fk_xxx"
    ],
    "ws_agent_key": "agent_xxx",
    "stream": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://app.emooai.com/open-api/v1/chat/messages' \
--header 'Emoo-User-Id: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "chat_id": 123,
    "query": "请帮我总结这份文档",
    "file_list": [
        "fk_xxx"
    ],
    "ws_agent_key": "agent_xxx",
    "stream": false
}'

返回响应

🟢200

application/json

成功（code=200）或业务错误（HTTP 仍 200）。stream=true 时为 SSE 流。可能错误码：

4044 chat_message_query_required（query 缺失或为空字符串）

4084 invalid_open_api_user_id

4092 invalid_open_api_ws_agent_key（ws_agent_key 不存在）

Body

示例

successquery_required

{
    "code": 200,
    "message": "success",
    "data": {
        "chat_id": 123,
        "complete_response": "AI 回答内容",
        "message_id": 456
    }
}

🟠400

🟠401

修改于 2026-09-04 02:55:27

创建对话

创建工作项