OpenAI 获取 ChatKit 线程

2026-11-19 18:07 更新

get /chatkit/threads/{thread_id}

按标识符获取 ChatKit 线程。

路径参数

  • thread_id: string

要获取的 ChatKit 线程标识符。

返回值

  • ChatKitThread object { id, created_at, object, 3 more }

ChatKit 线程及其当前状态。

  • id: string

线程的标识符。

  • created_at: integer

线程创建时的 Unix 时间戳,单位为秒。

format: unixtime

  • object: "chatkit.thread" (default: "chatkit.thread")

对象类型,固定为 chatkit.thread。

  • "chatkit.thread"

  • status: Active { type } or Locked { reason, type } or Closed { reason, type }

线程的当前状态。新建线程默认为 active。

  • Active object { type }

线程处于活动状态。

  • type: "active" (default: "active")

状态类型,固定为 active。

  • "active"

  • Locked object { reason, type }

线程已锁定,无法接收新输入。

  • reason: string or null

线程锁定的原因。没有记录原因时默认为 null。

  • type: "locked" (default: "locked")

状态类型,固定为 locked。

  • "locked"

  • Closed object { reason, type }

线程已关闭。

  • reason: string or null

线程关闭的原因。没有记录原因时默认为 null。

  • type: "closed" (default: "closed")

状态类型,固定为 closed。

  • "closed"

  • title: string or null

可供阅读的线程标题。尚未生成标题时默认为 null。

  • user: string

标识该线程所属终端用户的字符串。

请求示例

## 在服务端设置 OPENAI_API_KEY 环境变量。
## 将线程 ID 替换为需要读取的 ChatKit 线程 ID。
curl https://api.openai.com/v1/chatkit/threads/cthr_abc123 \
  -H "OpenAI-Beta: chatkit_beta=v1" \
  -H "Authorization: Bearer $OPENAI_API_KEY"

响应示例

{
  "id": "cthr_abc123",
  "object": "chatkit.thread",
  "title": "需升级处理的客户问题",
  "created_at": 1712345600,
  "status": {
    "type": "active"
  },
  "user": "user_123"
}

取得线程 ID 后,可列出 ChatKit 线程条目 查看消息等条目。

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号