1. 文件管理
NarratorAI(解说大师)开放接口
  • 产品介绍
    • 产品概述
    • 版本更新说明
  • 快速开始
    • 开通服务
    • 开始接入API
  • 功能指南
    • 视频翻译
    • 视频解说
    • 字幕翻译
    • 字幕提取
    • 视频压制
    • 视频擦除
  • AI解说大师工具箱
    • AI解说大师自定义字幕预览工具
      GET
    • AI解说大师智能封面生成工具
      GET
  • 项目文件接口
    • 项目管理
      • 创建项目
      • 获取项目列表
    • 文件管理
      • 百度网盘转存接口
      • 百度网盘转存任务
      • 文件上传查询
      • 上传文件
      • 文件URL上传
      • 重命名文件
      • 获取文件详情
      • 删除文件
      • 百度网盘单文件转存
  • 视频翻译接口
    • 翻译可用模型
    • 创建视频翻译任务
    • 任务确认
    • 更新本土化映射/翻译字幕
    • 更新任务的原字幕内容
    • 获取视频翻译任务列表
    • 获取视频翻译任务详情
  • 视频解说接口
    • 第一人称/爆款解说分步
      • 计算爆款解说总任务消耗点数
      • 创建字幕对齐任务
      • 创建爆款解说学习模型任务
      • 创建爆款解说生成解说文案任务
      • 创建合成视频剪辑数据
      • 创建爆款解说合成视频任务
      • 查询爆款解说任务列表
      • 查询爆款解说任务
      • 爆款解说全素材验证
      • 查询爆款解说类型
      • 查询爆款解说模型版本
    • 通用爆款解说接口
      • 创建通用爆款解说(短剧)
      • 查询通用爆款解说(短剧)
      • 创建通用爆款解说(电影)
      • 查询通用爆款解说(电影)
    • 短剧解说接口(六脉神剑)
      • 任务管理
        • 创建解说任务
        • 剪辑参数
        • 获取任务列表
        • 获取单个任务详情
        • 任务点数消耗计算
      • 解说视频资源
        • 获取可解说的视频资源列表
        • 获取单个视频资源详情
      • 创建通用解说任务
    • 语音克隆
      • 创建语音克隆任务
      • 查询语音克隆任务
    • TTS语音合成
      • 创建TTS合成任务
  • 视频处理接口
    • 视频字幕擦除任务
    • 视频字幕提取任务
    • 视频字幕蒙版任务
    • 视频字幕压制任务
    • 视频字幕擦除任务 v2
    • 视频字幕提取任务 v2
  • 长文本/小说翻译
    • 创建长文本/小说翻译任务
    • 查询长文本/小说翻译任务状态
  • 文件管理
    • 创建打包下载任务
      POST
    • 上传转存任务
      POST
    • 获取打包下载任务结果
      POST
    • 获取文件下载链接接口
      POST
    • 获取空间使用信息接口
      GET
    • 用户传输文件列表
      GET
    • 获取文件列表
      GET
    • 删除用户文件
      DELETE
    • 本地上传
      POST
    • 获取用户素材
      GET
    • 预转存接口
      POST
  • 用户管理
    • 用户账户余额
    • 创建子app key 接口
    • 子appkey增加额度
    • 获取子key列表
  • FAQ
    • 常见问题解答 (FAQ)
  • 数据模型
    • Schemas
      • UserSignUpResponse
      • VideoType
      • ValidationError
      • FileUpdate
      • ApiResponseModel[NovelTranslationResponse]
      • CommentaryTaskCreateParams
      • CreateVideoComposingRequest
      • PreTransferResponse
      • NovelTranslationResponse
      • CreateGenerateWritingResponse
      • File
      • HTTPValidationError
      • ApiResponseModel[TaskCreatedResponse]
      • SuccessDataResponseModel[TaskConsumePointsResponse]
      • TaskCreatedResponse
      • ApiResponseModel[TaskStatusResponse]
      • SuccessDataResponseModel[TaskResponse]
      • TextToSpeechRequestParams
      • TaskStatusResponse
      • SuccessDataResponseModel[UserBalance]
      • VoiceCloneModel
      • TaskStatusQueryParams
      • TaskConsumePoints
      • VoiceCloneRequestParams
      • TaskConsumePointsResponse
      • TaskCreate
      • TaskResponse
      • TaskType
      • TranslateTaskCreateParams
      • UserBalance
    • FailerResponseModel
    • UserAppKeyListResponse
    • JWTAuthenticErrorResponse
    • UserAppKey
  1. 文件管理

获取文件列表

GET
/v2/files/list

请求参数

Query 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET '/v2/files/list?page=1&page_size=20&order_by=file_size&order=asc&search=' \
--header 'app-key: {{app_key}}'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": 10000,
    "message": "success",
    "data": {
        "total": 30,
        "page": 1,
        "page_size": 20,
        "total_pages": 2,
        "items": [
            {
                "file_id": "fc49dde418f4443cbbb8456944cb1c04",
                "file_name": "8.srt",
                "file_size": 1623,
                "suffix": "srt",
                "category": 6,
                "completed_time": "2025-12-04 14:04:56",
                "created_at": "2025-12-04 14:04:53"
            },
            {
                "file_id": "6d5a8d914da34c588070b54ae27129c1",
                "file_name": "6.srt",
                "file_size": 1677,
                "suffix": "srt",
                "category": 6,
                "completed_time": "2025-12-04 14:04:50",
                "created_at": "2025-12-04 14:04:48"
            },
            {
                "file_id": "37ca8cc7a1fb4b999c79bdaf698daa02",
                "file_name": "5.srt",
                "file_size": 1922,
                "suffix": "srt",
                "category": 6,
                "completed_time": "2025-12-04 14:04:47",
                "created_at": "2025-12-04 14:04:45"
            },
            {
                "file_id": "557935f785b24049899d4d57b7543c38",
                "file_name": "7.srt",
                "file_size": 2903,
                "suffix": "srt",
                "category": 6,
                "completed_time": "2025-12-04 14:04:53",
                "created_at": "2025-12-04 14:04:51"
            },
            {
                "file_id": "357ed345f54e43b7aa5e2e658c7c6e26",
                "file_name": "1204小宅蜡笔小新爆款.srt",
                "file_size": 3143,
                "suffix": "srt",
                "category": 4,
                "completed_time": "2025-12-05 15:21:28",
                "created_at": "2025-12-05 15:21:20"
            },
            {
                "file_id": "ea992f035d6741d5830eb62b3db80a66",
                "file_name": "4.srt",
                "file_size": 3642,
                "suffix": "srt",
                "category": 6,
                "completed_time": "2025-12-04 14:04:44",
                "created_at": "2025-12-04 14:04:42"
            },
            {
                "file_id": "50bbfc1b11894fd087d0511632d5dfe9",
                "file_name": "10.srt",
                "file_size": 3852,
                "suffix": "srt",
                "category": 6,
                "completed_time": "2025-12-04 14:05:02",
                "created_at": "2025-12-04 14:05:00"
            },
            {
                "file_id": "8a36a05ceaab4b8c80b78ed4f1ac5565",
                "file_name": "9.srt",
                "file_size": 4185,
                "suffix": "srt",
                "category": 6,
                "completed_time": "2025-12-04 14:04:59",
                "created_at": "2025-12-04 14:04:57"
            },
            {
                "file_id": "e230c08c6d35451ba9e66fab76a231e6",
                "file_name": "3.srt",
                "file_size": 4445,
                "suffix": "srt",
                "category": 6,
                "completed_time": "2025-12-04 14:04:42",
                "created_at": "2025-12-04 14:04:40"
            },
            {
                "file_id": "ea859a9792554de2abd7952ad8da0c3f",
                "file_name": "2(1).srt",
                "file_size": 4870,
                "suffix": "srt",
                "category": 6,
                "completed_time": "2025-12-04 14:33:05",
                "created_at": "2025-12-04 14:33:03"
            },
            {
                "file_id": "1d1dd5ab4fbf4473a29cacdd54cf8a93",
                "file_name": "小宅丧尸.srt",
                "file_size": 8732,
                "suffix": "srt",
                "category": 4,
                "completed_time": "2025-12-05 15:21:35",
                "created_at": "2025-12-05 15:21:20"
            },
            {
                "file_id": "46555bc7b9a144f99a5fc8beb4751bde",
                "file_name": "1.srt",
                "file_size": 93766,
                "suffix": "srt",
                "category": 4,
                "completed_time": "2025-12-05 10:58:15",
                "created_at": "2025-12-05 10:58:10"
            },
            {
                "file_id": "e5fe1f54427c47369372befacf2b201a",
                "file_name": "6.mp4",
                "file_size": 47986614,
                "suffix": "mp4",
                "category": 1,
                "completed_time": "2025-12-04 14:04:55",
                "created_at": "2025-12-04 14:04:23"
            },
            {
                "file_id": "1b888842df244a30a9abddca1bf64fd2",
                "file_name": "8.mp4",
                "file_size": 60895652,
                "suffix": "mp4",
                "category": 1,
                "completed_time": "2025-12-04 14:05:20",
                "created_at": "2025-12-04 14:04:28"
            },
            {
                "file_id": "97a0cd406c754fee9ad2a40c7fd4f577",
                "file_name": "7.mp4",
                "file_size": 69264138,
                "suffix": "mp4",
                "category": 1,
                "completed_time": "2025-12-04 14:05:22",
                "created_at": "2025-12-04 14:04:25"
            },
            {
                "file_id": "c0f51e6aace7480a876cba4fea00c6fa",
                "file_name": "5.mp4",
                "file_size": 72899659,
                "suffix": "mp4",
                "category": 1,
                "completed_time": "2025-12-04 14:05:18",
                "created_at": "2025-12-04 14:04:21"
            },
            {
                "file_id": "14c10768044f49fba118df6f2f068068",
                "file_name": "10.mp4",
                "file_size": 105675989,
                "suffix": "mp4",
                "category": 1,
                "completed_time": "2025-12-04 14:05:25",
                "created_at": "2025-12-04 14:04:32"
            },
            {
                "file_id": "6aba18e98c004cc8b0def5a66b268edb",
                "file_name": "4.mp4",
                "file_size": 116273203,
                "suffix": "mp4",
                "category": 1,
                "completed_time": "2025-12-04 14:05:15",
                "created_at": "2025-12-04 14:04:18"
            },
            {
                "file_id": "7ddcad25f9bf425097e936361e008647",
                "file_name": "9.mp4",
                "file_size": 127637713,
                "suffix": "mp4",
                "category": 1,
                "completed_time": "2025-12-04 14:05:27",
                "created_at": "2025-12-04 14:04:30"
            },
            {
                "file_id": "1b5308b0ca1242c8a9a327aa9be72bd8",
                "file_name": "3.mp4",
                "file_size": 129873049,
                "suffix": "mp4",
                "category": 1,
                "completed_time": "2025-12-04 14:05:14",
                "created_at": "2025-12-04 14:04:16"
            }
        ]
    }
}
🟢200成功
修改于 2025-12-08 09:26:28
上一页
用户传输文件列表
下一页
删除用户文件
Built with