Bu sayfa şimdilik yalnızca Çince. Gezinme ve menüler zaten Türkçe.

列出文件

GET https://api.inoneapi.com/v1/files

分页查询当前 API Key 的文件元数据。按创建时间倒序排列，同一创建时间按 ID 倒序排列；不会下载文件或返回签名 URL。

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

请求参数

参数类型必填说明
limitinteger否默认 20，范围 1–100。
afterstring否上一页的 last_id。首个请求省略；游标必须存在且属于当前 Key。

不提供 offset、排序方向、文件类型或状态筛选参数。不要在完成分页前删除当前游标对应的元数据。

请求示例

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

curl  --get https://api.inoneapi.com/v1/files \
  -H "Authorization: Bearer $INONEAPI_API_KEY" \
  --data-urlencode limit=20

响应说明

{
  "object": "list",
  "data": [
    {
      "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"
    }
  ],
  "has_more": false,
  "first_id": "file_ioa_0123456789abcdef0123456789abcdef",
  "last_id": "file_ioa_0123456789abcdef0123456789abcdef"
}

object 固定为 list；data 为文件元数据数组，字段与上传响应一致；has_more 表示是否还有下一页；first_id、last_id 是本页首尾 ID。空页返回 data: []、has_more: false，两个 ID 均为空字符串。以 has_more 判断结束，不要仅根据数量猜测。

错误与边界

limit 非整数或超出范围、after 格式错误返回 400 INVALID_FILE_REQUEST；游标不存在或属于其他 Key 返回 404 FILE_NOT_FOUND；数据库失败返回 503 FILE_STORAGE_UNAVAILABLE。429 还可能来自 Key 限流，应遵循 Retry-After（如果返回）。

列表包含 ready 与 uploading 记录。COS 生命周期删除对象不会同步删除元数据，因此旧的 ready 记录不证明文件仍可读取。分页不是固定快照，并发上传不会自动出现在已遍历的页中；需要最新内容时从第一页重新查询。

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

Dosyaları listele · Belgeler · InOneAPI