列出用户文件

国内端点

https://api.qnaigc.com

GET

/v1/files

获取当前用户的文件列表。支持按状态过滤和游标分页。

分页使用游标方式，通过 after 参数传入上一页最后一条记录的 ID 来获取下一页数据。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

返回响应

🟢200

application/json

成功返回文件列表

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.qnaigc.com/v1/files?status&limit&after&order' \
--header 'Authorization: Bearer <token>'

响应示例

{
    "object": "list",
    "data": [
        {
            "id": "qfile-12345-1705382400-abc123",
            "object": "file",
            "status": "ready",
            "model": "gemini-2.0-flash",
            "created_at": 1705382400,
            "synced_at": 1705382450,
            "expires_at": 1705555200,
            "file_name": "sample.pdf",
            "file_size": 1048576,
            "content_type": "application/pdf"
        },
        {
            "id": "qfile-12345-1705296000-def456",
            "object": "file",
            "status": "expired",
            "model": "gpt-4o",
            "created_at": 1705296000,
            "synced_at": 1705296100,
            "expires_at": 1705468800,
            "file_name": "image.png",
            "file_size": 204800,
            "content_type": "image/png"
        }
    ],
    "has_more": true,
    "first_id": "qfile-12345-1705382400-abc123",
    "last_id": "qfile-12345-1705296000-def456"
}

修改于 2026-02-10 13:58:40

查询文件状态

ChatCompletionRequest