文件
查看文件
查看文件元数据,包括识别类型和可下载状态。
先调用「上传文件」,用返回的文件 ID 替换示例文件 ID。
GET
/file/v1/files/{file_id}● 支持请求参数
file_idstring必填path: The ID of the file to use for this request.
返回
200 file
错误按 OpenAI 格式返回,参见 错误码
响应
HTTP 200
OK
application/json
| 名称 | 类型 | 说明 |
|---|---|---|
| id | string | The file identifier, which can be referenced in the API endpoints. |
| bytes | integer | The size of the file, in bytes. |
| created_at | integer | The Unix timestamp (in seconds) for when the file was created. |
| expires_at | integer | The Unix timestamp (in seconds) for when the file will expire. |
| filename | string | The name of the file. |
| object | string | The object type, which is always `file`. |
| purpose | string | Upload purpose. Image references in conversations require user_data. |
| status | string | Deprecated. The current status of the file, which can be either `uploaded`, `processed`, or `error`. |
| status_details | string | null | Deprecated; always null or absent. |
| mime_type | string | Content-detected MIME type. |
| downloadable | boolean | Tenant-owned live files can be downloaded through this face. |
| scope | object | Present for session output files. |
| scope.type | string | Kind of scope; always `session`. |
| scope.id | string | Id of the session the file belongs to. |
| relative_path | string | Path within the session output directory; present for session outputs. |
| revision | integer | Session output revision; present for session outputs. |