上传文件

开发中

POST

/api/doubao/files/upload

🔑 需要 API Token 认证（Bearer Token）

上传本地文件到平台，供后续模型调用作为输入（如图片、视频、文档等）。

上游 Action：UploadFile

Content-Type：multipart/form-data

若返回 Status=processing，建议调用「查询文件」轮询至 active 后再引用

请求参数

Header 参数

Body 参数multipart/form-data必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://ai.tiantoken.com/api/doubao/files/upload' \
--header 'Authorization: Bearer ' \
--header 'New-Api-User: 1' \
--form 'file=@"(binary)"' \
--form 'purpose="user_data"'

返回响应

🟢200成功

application/json

上传受理成功（可能仍为 processing）

Bodyapplication/json

示例

{
    "Id": "file-20251018114827-6zgrb",
    "FileName": "demo.mp4",
    "FileSize": 695110,
    "Purpose": "user_data",
    "Status": "processing",
    "CreateTime": 1760759307,
    "UpdateTime": 1760759307
}

🟠400

🟠401

🔴503

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

文件列表

查询文件