列出消息
GET
https://api.openai.com/v1/threads/{thread_id}/messages请求参数
Path 参数
thread_id
string
必需
Query 参数
limit
integer
可选
要返回的对象数量的限制。限制范围可以在 1 到 100 之间,默认值为 20。
order
string
可选
created_at按对象的时间戳排序。asc对于升序和desc降序。
after
string
可选
用于分页的光标。after是定义您在列表中位置的对象 ID。例如,如果您发出列表请求并收到 100 个以 obj_foo 结尾的对象,则后续调用可以包含 after=obj_foo 以获取列表的下一页。
before
string
可选
用于分页的光标。before是定义您在列表中位置的对象 ID。例如,如果您发出列表请求并收到 100 个以 obj_foo 结尾的对象,则后续调用可以包含 before=obj_foo 以获取列表的上一页。
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
object
string
必需
data
array [object {10}]
必需
id
string
必需
object
string
必需
created_at
integer
必需
thread_id
string
必需
role
string
必需
content
array [object {2}]
必需
file_ids
array[string]
必需
assistant_id
null
必需
run_id
null
必需
metadata
object
必需
first_id
string
必需
last_id
string
必需
has_more
boolean
必需
示例
{
"object": "list",
"data": [
{
"id": "msg_abc123",
"object": "thread.message",
"created_at": 1699016383,
"thread_id": "thread_abc123",
"role": "user",
"content": [
{
"type": "text",
"text": {
"value": "How does AI work? Explain it in simple terms.",
"annotations": []
}
}
],
"file_ids": [],
"assistant_id": null,
"run_id": null,
"metadata": {}
},
{
"id": "msg_abc456",
"object": "thread.message",
"created_at": 1699016383,
"thread_id": "thread_abc123",
"role": "user",
"content": [
{
"type": "text",
"text": {
"value": "Hello, what is AI?",
"annotations": []
}
}
],
"file_ids": [
"file-abc123"
],
"assistant_id": null,
"run_id": null,
"metadata": {}
}
],
"first_id": "msg_abc123",
"last_id": "msg_abc456",
"has_more": false
}
修改于 10 个月前