Gemini Files 与缓存

上传 Gemini 文件

上传字节或启动可恢复上传。

POSThttps://api.tokenlab.sh/upload/v1beta/files
上传字节或启动可恢复上传。对于可恢复上传的启动,请发送元数据并读取 X-Goog-Upload-URL。仅在返回的 URL 处继续操作。
curl -X POST "https://example.com/upload/v1beta/files" \  -H "Content-Type: application/json" \  -d '{}'
{  "file": {    "name": "string",    "displayName": "string",    "mimeType": "string",    "sizeBytes": "string",    "uri": "string",    "state": "string",    "createTime": "2019-08-24T14:15:22Z",    "updateTime": "2019-08-24T14:15:22Z",    "expirationTime": "2019-08-24T14:15:22Z",    "error": {}  }}

授权

AuthorizationBearer <token>

API Key 身份验证。在 Dashboard > API > API Keys 中创建或管理 API Key。

位置: header

查询参数

key?string

替代 Bearer 或 x-goog-api-key 的 API key。

请求头

Idempotency-Key?string

在恢复创建响应时重复使用相同的 key 和请求体。使用相同的 key 但提供不同的请求体将返回冲突。

X-Goog-Upload-Protocol?string

上传协议,例如 resumable。

X-Goog-Upload-Command?string

上传命令,例如 start 或 upload、finalize。

X-Goog-Upload-Header-Content-Length?string

启动可恢复上传时预期的文件字节长度。

X-Goog-Upload-Header-Content-Type?string

启动可恢复上传时的文件 MIME 类型。

请求体

Gemini 文件元数据请求。受支持的字段和值由服务验证。文件字节通过 /upload/v1beta/files 上传。

响应

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json