# 获取文件信息

返回单个文件的元数据和 1 小时有效的读取 URL。

## GET /v1/files/{id}

> 获取文件信息

返回单个文件的元数据和 1 小时有效的读取 URL。

### Authentication

`Authorization: Bearer tr-xxx`

### Path Parameters

- **id** `string` **(required)**  
  文件 ID（`file-` 前缀）

### Response

- **id** `string`  
  文件 ID（`file-` 前缀）
- **object** `string`  
  
- **bytes** `integer`  
  实际字节数（以对象存储 HEAD 为准）
- **created_at** `integer`  
  上传时间，Unix 秒
- **filename** `string`  
  上传时的原文件名
- **purpose** `string`  
  调用方传入的业务标签
- **mime_type** `string`  
  MIME 类型
- **type** ``image` | `video` | `audio` | `file``  
  自动归类的文件种类
- **url** `string`  
  1 小时有效的 HTTPS 读取 URL
- **expires_at** `integer`  
  存储到期时间（Unix 秒），超配额时非空

### Error Codes

- `401`: 
- `404`: 文件不存在或不属于当前用户