OpenAI 更新对话

请求体的媒体类型为 application/json。

更新对话

post /conversations/{conversation_id}

更新对话。

路径参数

• conversation_id: string

请求体参数

• metadata: Metadata or null

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

返回值

• 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"

示例

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

## [中文] 发送POST请求；端点为 /v1/conversations/$CONVERSATION_ID，凭证及资源ID由调用方提供。
curl https://api.openai.com/v1/conversations/$CONVERSATION_ID \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{
          "metadata": {
            "foo": "string"
          }
        }'

响应

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

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

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

示例

代码内文字译释：project-x：项目X。

## [中文] 发送POST请求；端点为 /v1/conversations/conv_123，凭证及资源ID由调用方提供。
curl https://api.openai.com/v1/conversations/conv_123 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{
    "metadata": {"topic": "project-x"}
  }'

响应

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

代码内文字译释：project-x：项目X。

{
  "id": "conv_123",
  "object": "conversation",
  "created_at": 1741900000,
  "metadata": {"topic": "project-x"}
}