Retrieve file (Gemini format)

Retrieves file metadata in Google Gemini API format.

Note: This endpoint returns file metadata only. Direct file content download is not supported by Gemini Files API. Use the file.uri field from the response to access the file content.

GET /genai/v1beta/files/{file_id}

Error

A valid request URL is required to generate request examples

200

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

Path Parameters

file_id · string · required

File ID

Response

200

application/json

Successful response

name · string

File resource name (e.g., files/abc123)

displayName · string

mimeType · string

sizeBytes · string

Size in bytes (returned as string by Gemini API)

createTime · string<date-time>

updateTime · string<date-time>

expirationTime · string<date-time>

sha256Hash · string

uri · string

URI for accessing the file content

state · enum<string>

Available options: STATE_UNSPECIFIED, PROCESSING, ACTIVE, FAILED

error · object

Show child attributes

videoMetadata · object

Show child attributes