OpenAI 检索对话

检索对话

get /conversations/{conversation_id}

获取对话。

路径参数

• conversation_id: string

返回值

• Conversation object { id, created_at, metadata, object }

• id: string

对话的唯一ID。

• created_at: integer（Unix 时间戳）

对话创建的时间，以自Unix纪元起经过的秒数表示。

• metadata: map[string]

可附加到对象的元数据，最多包含16个键值对。可用于以结构化格式保存对象的附加信息，并通过API或控制台查询对象。键为字符串，最长64个字符；值为字符串，最长512个字符。

• object: "conversation"（默认值为 conversation）

对象类型，固定为conversation。

• "conversation"

示例

## [中文] 获取本节资源；端点为 /v1/conversations/$CONVERSATION_ID，凭证及资源ID由调用方提供。
curl https://api.openai.com/v1/conversations/$CONVERSATION_ID \
    -H "Authorization: Bearer $OPENAI_API_KEY"

响应

中文说明：以下为来源中的JSON响应示例，字段名、枚举和标识符保留，示例值不代表实际调用结果。

代码内文字译释：string：字符串占位值。

{
  "id": "id",
  "created_at": 0,
  "metadata": {
    "foo": "string"
  },
  "object": "conversation"
}

示例

## [中文] 获取本节资源；端点为 /v1/conversations/conv_123，凭证及资源ID由调用方提供。
curl https://api.openai.com/v1/conversations/conv_123 \
  -H "Authorization: Bearer $OPENAI_API_KEY"

响应

中文说明：以下为来源中的JSON响应示例，字段名、枚举和标识符保留，示例值不代表实际调用结果。

代码内文字译释：demo：演示。

{
  "id": "conv_123",
  "object": "conversation",
  "created_at": 1741900000,
  "metadata": {"topic": "demo"}
}