**版本：202601**

# 查询文件详情

**GET** `/openapi/2026-01/file/detail/:file_uri`

获取服务器上指定文件的详细信息。

## 请求

**Path参数**

- `file_uri` string (required)

  文件 URI

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `file` object

    文件

    - `upload_link` string

      上传文件链接
    - `file_uri` string

      文件 URI
    - `folder` string

      文件夹
    - `size` int32

      文件大小
    - `type` string

      文件类型
    - `origin_link` string

      原始链接
    - `desc` string

      文件描述
    - `aspect_ratio` string

      文件宽高比
    - `width` int32

      文件宽度
    - `height` int32

      文件高度
    - `created_at` string

      创建时间
    - `updated_at` string

      更新时间

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "file": {
      "upload_link": "string",
      "file_uri": "string",
      "folder": "string",
      "size": 0,
      "type": "string",
      "origin_link": "string",
      "desc": "string",
      "aspect_ratio": "string",
      "width": 0,
      "height": 0,
      "created_at": "string",
      "updated_at": "string"
    }
  }
}
```