创建文件上传任务

文件上传

这是一个异步文件上传导入任务。本接口专为 Gemini 模型大文件理解场景 优化。

💡 为什么使用此接口？

Vertex AI 在通过 HTTP 直接传入文件进行理解时，存在 15MB 的硬性限制。对于大于 15MB 的文件（如长视频、高分辨率图像），官方要求必须使用 Google Cloud Storage (GCS) 链接。
本接口旨在简化该流程：您只需提供文件的公开 URL，系统将自动把文件转存至 GCS 并对接 Vertex AI，您无需自行配置或管理 GCS 存储桶。

接口约束

支持场景：仅适用于 Gemini 模型的大文件（>15MB）多模态理解。

文件大小：最大支持 2GB。

网络要求：source_url 必须是公网可访问的 HTTP/HTTPS 地址。

调用流程

提交任务：调用本接口提交 source_url。

获取 ID：接口立即返回 file_id，任务进入后台异步处理队列。

检查状态：客户端需轮询 GET /files/{file_id} 接口，直到文件状态变更为 ready 。

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

curl --location 'https://openai.qiniu.com/v1/files' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "gemini-3.0-pro-preview", "source_url": "https://aitoken-public.qnaigc.com/example/generate-video/running-man.jpg", "expires_in": 172800 }'

{ "id": "qfile-12345-1770727746152401856-01d742", "object": "file", "status": "pending", "model": "gemini-3.0-pro-preview", "created_at": 1770727746, "expires_at": 1770900546 }

文件上传

💡 为什么使用此接口？

接口约束

调用流程

请求参数

返回响应

创建文件上传任务

文件上传#

💡 为什么使用此接口？#

接口约束#

调用流程#

请求参数

返回响应

文件上传

💡 为什么使用此接口？

接口约束

调用流程