Messages

消息列表

返回指定线程的消息列表。

GET

/threads/{thread_id}/messages

cURL

curl --request GET \
  --url 'https://dashscope.aliyuncs.com/api/v1/threads/{thread_id}/messages' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

{
  "object": "list",
  "data": [
    {
      "id": "message_f1933671-19e1-4162-ad25-7326165123e1",
      "object": "thread.message",
      "created_at": 1711508433283,
      "thread_id": "thread_e99a9fe7-0433-426f-98ad-a5139c36579c",
      "assistant_id": "",
      "run_id": "",
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": {
            "value": "你是谁",
            "annotations": []
          }
        }
      ],
      "metadata": {},
      "name": "",
      "plugin_call": {},
      "tool_calls": [],
      "status": ""
    }
  ],
  "first_id": "message_f1933671-19e1-4162-ad25-7326165123e1",
  "last_id": "message_f1933671-19e1-4162-ad25-7326165123e1",
  "has_more": false,
  "request_id": "78f7d607-4a9a-90c6-8040-d3f81c84d60a"
}

Authorizations

string

header

required

DashScope API Key，在控制台 API Key 页面（https://bailian.console.aliyun.com/settings/apikey）获取。请求头格式：Authorization: Bearer $DASHSCOPE_API_KEY。

Path Parameters

string

required

message 所传入的 thread ID。

Query Parameters

integer

创建 message 的数量。

string

按照创建时间升序或降序，可选 desc（默认）或 asc。

Response

200-application/json

cURL

curl --request GET \
  --url 'https://dashscope.aliyuncs.com/api/v1/threads/{thread_id}/messages' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

{
  "object": "list",
  "data": [
    {
      "id": "message_f1933671-19e1-4162-ad25-7326165123e1",
      "object": "thread.message",
      "created_at": 1711508433283,
      "thread_id": "thread_e99a9fe7-0433-426f-98ad-a5139c36579c",
      "assistant_id": "",
      "run_id": "",
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": {
            "value": "你是谁",
            "annotations": []
          }
        }
      ],
      "metadata": {},
      "name": "",
      "plugin_call": {},
      "tool_calls": [],
      "status": ""
    }
  ],
  "first_id": "message_f1933671-19e1-4162-ad25-7326165123e1",
  "last_id": "message_f1933671-19e1-4162-ad25-7326165123e1",
  "has_more": false,
  "request_id": "78f7d607-4a9a-90c6-8040-d3f81c84d60a"
}