文件列表

开发中

POST

/api/doubao/files/list

🔑 需要 API Token 认证（Bearer Token）

分页查询当前账号下的文件列表，支持过滤与排序。

路由：POST /api/doubao/files/list（controller.DoubaoFileList）

请求结构体：doubao.FileListRequest

响应结构体：doubao.FileListResponse（列表项为 doubao.FileResponse）

上游转发：POST {channel.BaseURL}?Action=ListFiles&Version=2024-01-01，请求体原样透传，响应原样回写

注意： Body 必须是合法 JSON（至少 {}）。字段均带 omitempty，全部选填；未传或为零值时不会序列化到上游。

请求参数

Header 参数

Body 参数application/json必填

示例

完整请求示例分页 + 排序带过滤条件最小请求（默认分页）

包含过滤、分页与排序的常用请求体

{
    "Filter": "Purpose=user_data",
    "PageNumber": 1,
    "PageSize": 20,
    "SortBy": "CreateTime"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

完整请求示例分页 + 排序带过滤条件最小请求（默认分页）

curl --location 'https://ai.tiantoken.com/api/doubao/files/list' \
--header 'Authorization: Bearer ' \
--header 'New-Api-User: 1' \
--header 'Content-Type: application/json' \
--data '{
    "Filter": "Purpose=user_data",
    "PageNumber": 1,
    "PageSize": 20,
    "SortBy": "CreateTime"
}'

返回响应

🟢200成功

application/json

查询成功。本平台将上游响应原样返回。

Bodyapplication/json

示例

成功（有数据）成功（空列表）

{
    "Items": [
        {
            "Id": "file-20251014203105-ll4pb",
            "FileName": "demo.mp4",
            "FileSize": 109322727,
            "Purpose": "user_data",
            "Status": "active",
            "CreateTime": 1760445065,
            "UpdateTime": 1760445100,
            "URL": "https://example.com/files/file-20251014203105-ll4pb"
        },
        {
            "Id": "file-20251014203036-24jvn",
            "FileName": "demo.png",
            "FileSize": 601,
            "Purpose": "user_data",
            "Status": "processing",
            "CreateTime": 1760445036,
            "UpdateTime": 1760445036
        }
    ],
    "PageNumber": 1,
    "PageSize": 20,
    "TotalCount": 2
}

🟠400

🟠401

🔴500

🔴503

修改于 2026-09-11 03:48:38

删除素材

上传文件