[AI] docs: 自动更新 OpenAI 中文翻译

docs/zh/api/reference/resources/beta/subresources/threads/subresources/messages/methods/retrieve.md

@@ -1,4 +1,4 @@
-> 有关完整的文档索引，请参阅 [llms.txt](/llms.txt)。文档页面的 Markdown 版本可通过在页面 URL 后追加 `.md` 来获取。
+> 如需查看完整文档索引，请参阅 [llms.txt](/llms.txt)。可通过在页面 URL 后追加 `.md` 来获取文档页面的 Markdown 版本。
 
 ## 检索消息
 
@@ -16,27 +16,27 @@
 
 - `Message object { id, assistant_id, attachments, 11 more }`
 
-  表示一个消息，位于 [线程](/docs/api-reference/threads).
+  表示一个中的消息 [thread](/docs/api-reference/threads).
 
   - `id: string`
 
     该标识符，可在 API 端点中引用。
 
   - `assistant_id: string or null`
 
-    如适用，此消息的作者 [助手](/docs/api-reference/assistants) 的 ID。
+    如果适用，生成该消息的 [assistant](/docs/api-reference/assistants) 的 ID。
 
   - `attachments: array of object { file_id, tools }  or null`
 
-    附加到消息的文件列表，以及它们被添加到的工具。
+    附加到该消息的文件列表，以及这些文件被添加到的工具。
 
     - `file_id: optional string`
 
-      要附加到消息的文件的 ID。
+      要附加到该消息的文件的 ID。
 
     - `tools: optional array of CodeInterpreterTool or object { type }`
 
-      要将此文件添加到的工具。
+      要添加该文件的工具。
 
       - `CodeInterpreterTool object { type }`
 
@@ -60,21 +60,21 @@
 
   - `content: array of ImageFileContentBlock or ImageURLContentBlock or TextContentBlock or RefusalContentBlock`
 
-    消息的内容，以文本和/或图像的数组形式呈现。
+    由文本和/或图像组成的消息内容数组。
 
     - `ImageFileContentBlock object { image_file, type }`
 
-      引用消息内容中的 [文件](/docs/api-reference/files) 中的图像。
+      引用消息内容中 [File](/docs/api-reference/files) 的图像。
 
       - `image_file: ImageFile`
 
         - `file_id: string`
 
-          消息内容中图像的 [文件](/docs/api-reference/files) ID。上传文件时设置 `purpose="vision"` ，以便之后需要显示文件内容时使用。
+          该 [File](/docs/api-reference/files) 消息内容中图像的 ID。如需稍后展示文件内容，请在上传 `purpose="vision"` 时设置该 ID。
 
         - `detail: optional "auto" or "low" or "high"`
 
-          如果由用户指定，则指定图像的细节级别。 `low` 使用的令牌较少，你可以选择使用高分辨率 `high`.
+          如果由用户指定，则指定图像的细节等级。 `low` 使用的 token 较少，你可以通过以下方式选择高分辨率 `high`.
 
           - `"auto"`
 
@@ -90,7 +90,7 @@
 
     - `ImageURLContentBlock object { image_url, type }`
 
-      在消息内容中引用图片 URL。
+      引用消息内容中的图片 URL。
 
       - `image_url: ImageURL`
 
@@ -100,7 +100,7 @@
 
         - `detail: optional "auto" or "low" or "high"`
 
-          指定图像的细节级别。 `low` 使用的令牌较少，你可以选择使用高分辨率 `high`。默认值为 `auto`
+          指定图片的细节级别。 `low` 使用的 token 较少，你可以通过以下方式选择高分辨率 `high`。默认值为 `auto`
 
           - `"auto"`
 
@@ -124,21 +124,21 @@
 
           - `FileCitationAnnotation object { end_index, file_citation, start_index, 2 more }`
 
-            消息中的引用，指向与助理或消息关联的特定文件中的特定引述。当助理使用“文件搜索”工具搜索文件时生成。
+            消息中的一条引用，指向来自与助手或该消息相关联的特定文件的特定引用片段。当助手使用 "file_search" 工具搜索文件时生成。
 
             - `end_index: number`
 
             - `file_citation: object { file_id }`
 
               - `file_id: string`
 
-                引用来源的特定文件的 ID。
+                该引用所属的特定文件的 ID。
 
             - `start_index: number`
 
             - `text: string`
 
-              消息内容中需要替换的文本。
+              消息内容中需要被替换的文本。
 
             - `type: "file_citation"`
 
@@ -148,21 +148,21 @@
 
           - `FilePathAnnotation object { end_index, file_path, start_index, 2 more }`
 
-            当助理使用 `code_interpreter` 工具生成文件时，所生成文件的 URL。
+            当助手使用 `code_interpreter` 工具生成文件时生成的该文件的 URL。
 
             - `end_index: number`
 
             - `file_path: object { file_id }`
 
               - `file_id: string`
 
-                所生成文件的 ID。
+                已生成文件的 ID。
 
             - `start_index: number`
 
             - `text: string`
 
-              消息内容中需要替换的文本。
+              消息内容中需要被替换的文本。
 
             - `type: "file_path"`
 
@@ -194,19 +194,19 @@
 
   - `created_at: number`
 
-    消息创建时的 Unix 时间戳（秒）。
+    消息创建时的 Unix 时间戳（以秒为单位）。
 
   - `incomplete_at: number or null`
 
-    消息被标记为不完整时的 Unix 时间戳（秒）。
+    消息被标记为未完成时的 Unix 时间戳（以秒为单位）。
 
   - `incomplete_details: object { reason }  or null`
 
-    对于不完整的消息，提供消息不完整原因的详细信息。
+    在未完成的消息上，关于消息未完成原因的详细信息。
 
     - `reason: "content_filter" or "max_tokens" or "run_cancelled" or 2 more`
 
-      消息不完整的原因。
+      消息未完成的原因。
 
       - `"content_filter"`
 
@@ -220,12 +220,12 @@
 
   - `metadata: Metadata or null`
 
-    可附加到对象上的 16 组键值对。这可以
-    用于以结构化格式存储关于该对象的额外信息，
-    并通过 API 或仪表盘查询对象。
+    可附加到对象的 16 个键值对集合。可以
+    用于以结构化格式存储对象的附加信息
+    ，并通过 API 或控制台查询对象。
 
-    键为长度上限 64 个字符的字符串。值为字符串，
-    长度上限 512 个字符。
+    键是字符串，最大长度为 64 个字符。值是字符串
+    ，最大长度为 512 个字符。
 
   - `object: "thread.message"`
 
@@ -235,19 +235,19 @@
 
   - `role: "user" or "assistant"`
 
-    生成消息的实体。可为 `user` 或 `assistant`.
+    生成消息的实体。其值为 `user` 或 `assistant`.
 
     - `"user"`
 
     - `"assistant"`
 
   - `run_id: string or null`
 
-    与该消息创建相关的 [run](/docs/api-reference/runs) 的 ID。值为 `null` 当通过创建消息或创建线程端点手动创建消息时。
+    该 [run](/docs/api-reference/runs) 的 ID,与创建此消息相关联。当通过手动调用 create message 或 create thread 端点创建消息时,该值为 `null` 。
 
   - `status: "in_progress" or "incomplete" or "completed"`
 
-    消息的状态，可为 `in_progress`, `incomplete`，或 `completed`.
+    消息的状态,可以是 `in_progress`, `incomplete`，之一,或 `completed`.
 
     - `"in_progress"`
 
@@ -257,7 +257,7 @@
 
   - `thread_id: string`
 
-    该 [线程](/docs/api-reference/threads) ID，即此消息所属的线程 ID。
+    该 [thread](/docs/api-reference/threads) 所属的 ID。
 
 ### 示例