Upload file (Gemini format)

Uploads a file using Google Gemini API format.

This is a multipart upload with two parts:

• “metadata”: JSON object containing file metadata
• “file”: Binary file content

Note: Direct file content download is not supported by Gemini Files API. Use the file.uri field from the response to access uploaded files.

POST /genai/upload/v1beta/files

Error

A valid request URL is required to generate request examples

200

{
  "file": {
    "name": "<string>",
    "displayName": "<string>",
    "mimeType": "<string>",
    "sizeBytes": "<string>",
    "createTime": "2023-11-07T05:31:56Z",
    "updateTime": "2023-11-07T05:31:56Z",
    "expirationTime": "2023-11-07T05:31:56Z",
    "sha256Hash": "<string>",
    "uri": "<string>",
    "error": {
      "code": 123,
      "message": "<string>"
    },
    "videoMetadata": {
      "videoDuration": "<string>"
    }
  }
}

Authorizations

BearerAuthBasicAuthVirtualKeyAuthApiKeyAuth

Authorization · string · header · required

Bearer token authentication. Use your provider API key or Bifrost authentication token. Virtual keys (prefixed with sk-bf-) can also be passed here.

Body

multipart/form-data

Multipart upload for Gemini Files API. Send two parts: - "metadata": JSON object {"file": {"displayName": ""}} - "file": binary content Note: Direct file content download is not supported by Gemini Files API. Use the file.uri field from the response to access the file.

file · file · required

metadata · object

JSON metadata part; see encoding at the path for contentType application/json.

Show child attributes

Response

200

application/json

Successful response

file · object

Show child attributes