Trang này hiện chỉ có bản tiếng Trung. Điều hướng và menu đã hiển thị bằng tiếng Việt.

获取文件

GET https://api.inoneapi.com/v1/files/{file_id}

获取一个文件的元数据，用于确认上传状态、检测类型和原始大小。此接口不返回文件字节、下载地址或签名 URL，也不检查 COS 中的对象是否仍然存在。

所有请求都使用 Authorization: Bearer $INONEAPI_API_KEY，无需请求体。文件严格按上传 Key 隔离，即使属于同一用户或项目也不能跨 Key 操作。文件操作不产生模型推理费用，不要求正余额，但仍受 Key 限流、并发限制与项目状态约束。

请求参数

参数	位置	类型	说明
`file_id`	path	string	必填，上传返回的完整 ID：`file_ioa_` 加 32 位小写十六进制字符。不是 Playground 附件 ID 或服务商 ID。

请求示例

以下 JavaScript 示例用于 Node.js 20+ 服务端；请先设置 INONEAPI_API_KEY。

curl  https://api.inoneapi.com/v1/files/file_ioa_0123456789abcdef0123456789abcdef \
  -H "Authorization: Bearer $INONEAPI_API_KEY"

响应说明

{
  "id": "file_ioa_0123456789abcdef0123456789abcdef",
  "object": "file",
  "filename": "sample.pdf",
  "mime_type": "application/pdf",
  "media_type": "document",
  "bytes": 1024,
  "status": "ready",
  "created_at": 1789430400,
  "purpose": "user_data"
}

成功返回 HTTP 200。id 为文件 ID，object 固定 file，filename 为原始文件名，mime_type 为内容检测 MIME，media_type 为 image/video/audio/document，bytes 为字节数，created_at 为 Unix 秒，purpose 固定 user_data。status 可能为 uploading 或 ready；只有 ready 能用于模型请求。

错误与边界

ID 格式错误、不存在或属于其他 Key 返回 404 FILE_NOT_FOUND；元数据读取失败返回 503 FILE_STORAGE_UNAVAILABLE。认证、Key 状态及限流错误遵循通用规则。

读取到 uploading 不会返回 409，而是 HTTP 200 的元数据；尝试引用未就绪文件才会失败。上传中断不保证自动恢复，不要无限轮询。公共文件由 COS 1 天生命周期异步清理，平台不返回 expires_at；旧记录仍可能显示 ready。对象被清理后应重新上传，不要把重复获取元数据当作续期。

文件指南 · POST /v1/files · 错误码