创建运行
POST
https://api.openai.com/v1/threads/{thread_id}/runs一个运行对象。
请求参数
Path 参数
thread_id
string
必需
要运行的线程的 ID。
Body 参数application/json
assistant_id
string
必需
用于执行此运行的助手的 ID 。
model
string
必需
用于执行此运行的模型的 ID 。如果此处提供了值,它将覆盖与助手关联的模型。如果没有,将使用与助手关联的模型。
instructions
string
必需
覆盖助手的默认系统消息。这对于修改每次运行的行为非常有用。
tools
array [object {3}]
可选
覆盖助手可用于此运行的工具。这对于修改每次运行的行为非常有用。
Code interpreter tool
object
可选
Retrieval tool
object
可选
Function tool
object
可选
metadata
object
可选
一组可附加到对象的 16 个键值对。这对于以结构化格式存储有关对象的附加信息非常有用。键的最大长度为 64 个字符,值的最大长度为 512 个字符。
示例
{
"assistant_id": "asst_nGl00s4xa9zmVY6Fvuvz9wwQ"
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
id
string
必需
object
string
必需
created_at
integer
必需
assistant_id
string
必需
thread_id
string
必需
status
string
必需
started_at
integer
必需
expires_at
null
必需
cancelled_at
null
必需
failed_at
null
必需
completed_at
integer
必需
last_error
null
必需
model
string
必需
instructions
null
必需
tools
array [object {1}]
必需
type
string
可选
file_ids
array[string]
必需
metadata
object
必需
示例
{
"id": "run_UWvV94U0FQYiT2rlbBrdEVmC",
"object": "thread.run",
"created_at": 1699063290,
"assistant_id": "asst_nGl00s4xa9zmVY6Fvuvz9wwQ",
"thread_id": "thread_BDDwIqM4KgHibXX3mqmN3Lgs",
"status": "queued",
"started_at": 1699063290,
"expires_at": null,
"cancelled_at": null,
"failed_at": null,
"completed_at": 1699063291,
"last_error": null,
"model": "gpt-4",
"instructions": null,
"tools": [
{
"type": "code_interpreter"
}
],
"file_ids": [
"file-9F1ex49ipEnKzyLUNnCA0Yzx",
"file-dEWwUbt2UGHp3v0e0DpCzemP"
],
"metadata": {}
}
修改于 10 个月前