会话

查询消息

GET

/conversations/{conversation_id}/items/{item_id}

Python

import os
from openai import OpenAI

client = OpenAI(
  api_key=os.getenv("DASHSCOPE_API_KEY"),
  base_url="https://dashscope.aliyuncs.com/api/v2/apps/protocols/compatible-mode/v1",
)

item = client.conversations.items.retrieve(
  "msg_xxx",
  conversation_id="conv_xxx"
)
print(item)

{
  "content": [
    {
      "text": "Alice's major is teacher education",
      "type": "input_text"
    }
  ],
  "id": "msg_xxx",
  "role": "user",
  "status": "completed",
  "type": "message"
}

鉴权

string

header

必填

千问云 API Key。详见获取 API Key。

路径参数

string

必填

会话 ID。

示例:conv_xxx

string

必填

消息 ID。

示例:msg_xxx

响应

200-application/json

string

消息 ID。

示例:msg_xxx

string

消息内容，支持纯文本字符串或结构化内容列表（如 ContentPart 对象数组）。

enum<string>

消息角色：user、assistant、system 或 developer。

可选值：user,assistant,system,developer

enum<string>

处理状态：in_progress、completed 或 incomplete。

可选值：in_progress,completed,incomplete

enum<string>

固定值 message。

可选值：message

Python

import os
from openai import OpenAI

client = OpenAI(
  api_key=os.getenv("DASHSCOPE_API_KEY"),
  base_url="https://dashscope.aliyuncs.com/api/v2/apps/protocols/compatible-mode/v1",
)

item = client.conversations.items.retrieve(
  "msg_xxx",
  conversation_id="conv_xxx"
)
print(item)

{
  "content": [
    {
      "text": "Alice's major is teacher education",
      "type": "input_text"
    }
  ],
  "id": "msg_xxx",
  "role": "user",
  "status": "completed",
  "type": "message"
}