API参考
请输入
- 火山方舟
Files API查询文件详情
复制全文
下载 pdfFiles API
查询文件详情
复制全文下载 pdf查询文件详情
文档反馈GET https://ark.cn-beijing.volces.com/api/v3/files/{file_id}
通过文件 ID 查询指定文件的详细信息。
鉴权
- API Key 鉴权，请在 API Key 管理 页面，获取长效 API Key。
请求参数
Path 参数
file_id string 必选 | 文件 ID
要查询的文件 ID
响应参数
created_at integer | 创建时间
文件上传时的 Unix 时间戳（秒）
expire_at integer | 过期时间
文件过期时间的 Unix 时间戳（秒）。文件过期后将无法访问，需重新上传
filename string | 原始文件名
上传时的原始文件名
id string | 文件 ID
文件的唯一标识符
object string | 对象类型
对象类型，固定为 file
purpose string | 文件用途
文件用途。常见取值为 user_data（作为模型推理输入数据使用）
status string | 文件状态
文件处理状态。常见取值为 active（处理完成，可用于推理）、processing（处理中）、failed（处理失败）
bytes integer | 文件大小
文件大小，单位为字节（Bytes）
注意
仅在文件处理状态 status 为 active 时返回。
download_url string | 下载 URL
指向底层 TOS 对象的预签名下载 URL，可用于直接下载该文件内容
error object | 错误信息
文件上传或处理失败时返回的错误信息对象，包含错误码、错误消息等字段
注意
仅在文件处理状态 status 为 failed 时返回。
code string | 错误码
error.code
机器可读的错误码
message string | 错误消息
error.message
人类可读的错误描述信息
param string | 错误参数
error.param
触发该错误的请求参数名（如有）
type string | 错误类型
error.type
错误类型标识
mime_type string | MIME 类型
文件的 MIME 类型，例如 video/mp4、image/jpeg
preprocess_configs object | 预处理配置
上传文件时设置的预处理规则配置，按文件类型分组（如视频抽帧规则）
video object | 视频预处理配置
preprocess_configs.video
视频文件的预处理配置
fps number | 抽帧帧率
preprocess_configs.video.fps
视频抽帧的帧率（Frames Per Second），用于设置视频预处理时每秒采样的画面帧数
model string | 预处理模型
preprocess_configs.video.model
视频预处理使用的模型标识符（可选）
默认
request
Curl
FILE_ID="your_file_id"
curl "https://ark.cn-beijing.volces.com/api/v3/files/$FILE_ID" \
-H "Authorization: Bearer $ARK_API_KEY"response
{
"object": "file",
"id": "file-20251119****",
"purpose": "user_data",
"filename": "demo.mp4",
"bytes": 18773126,
"mime_type": "video/mp4",
"created_at": 1763552708,
"expire_at": 1764157507,
"status": "active"
}最近更新时间：2026.08.21 11:18:09
这个页面对您有帮助吗？
有用
有用
无用
无用