查询文件状态

根据文件 ID 查询文件的详细信息和当前状态。

状态说明：

pending：等待处理

uploading：正在上传到目标存储

ready：上传完成，可用于推理

failed：上传失败，查看 error 字段获取详细信息

expired：文件已过期，需要重新创建

🚀 调用示例：从导入到推理

以下展示了当文件处理完成并获得 file_id 后，如何在模型推理接口中使用该文件。

场景：视频理解

假设您已通过本接口上传了一个长视频，并获得了文件 ID：qfile-123-1770719212268100147-e0011b。

请求说明：
在推理接口（Chat/Completions）的 messages 数组中，将 type 指定为 file 或 image_url ，并填入对应的 file_id 或 url。

请求报文 (JSON)：

{
    "stream": false,
    "model": "gemini-3.0-pro-preview",
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "这段视频里发生了什么？请详细描述。"
                },
                {
                    "type": "file",
                    "file": {
                        "file_id": "qfile-123-1770719212268100147-e0011b",
                        "format": "video/mp4"
                    }
                }
            ]
        }
    ]
}

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

{ "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" }

🚀 调用示例：从导入到推理

场景：视频理解

请求参数

返回响应

查询文件状态

🚀 调用示例：从导入到推理#

场景：视频理解#

请求参数

返回响应

🚀 调用示例：从导入到推理

场景：视频理解