> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkmodel.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Gemini file

> Poll this resource after completing an upload. Only an `active` file has a usable `uri` for Gemini-native `fileData.fileUri` input.

The returned `gs://` URI is an account-scoped Gemini reference, not a public download URL or a cross-provider asset identifier.




## OpenAPI

````yaml /openapi/files/_get-file.yaml get /files/{file_id}
openapi: 3.0.3
info:
  title: Get Gemini file
  version: 1.0.0
  description: >-
    Read Gemini file-processing status and retrieve its native file URI when
    active.
servers:
  - url: https://api.linkmodel.ai/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Gemini
  - name: files
paths:
  /files/{file_id}:
    get:
      tags:
        - Gemini
        - files
      summary: Get Gemini file
      description: >
        Poll this resource after completing an upload. Only an `active` file has
        a usable `uri` for Gemini-native `fileData.fileUri` input.


        The returned `gs://` URI is an account-scoped Gemini reference, not a
        public download URL or a cross-provider asset identifier.
      operationId: get-gemini-file
      parameters:
        - name: file_id
          in: path
          required: true
          description: File identifier returned when the upload session was created.
          schema:
            type: string
          example: file_example123
      responses:
        '200':
          description: Current Gemini file resource.
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - data
                properties:
                  code:
                    type: integer
                    enum:
                      - 0
                    example: 0
                  data:
                    type: object
                    required:
                      - file_id
                      - status
                    properties:
                      file_id:
                        type: string
                        example: file_example123
                      status:
                        type: string
                        description: >-
                          Common lifecycle values include `pending_upload`,
                          `transferring`, and `active`.
                        example: active
                      filename:
                        type: string
                        example: sample.mp4
                      mime_type:
                        type: string
                        example: video/mp4
                      bytes:
                        type: integer
                        format: int64
                        example: 35077
                      uri:
                        type: string
                        description: >-
                          Present when active. Pass unchanged as Gemini
                          `fileData.fileUri`.
                        example: >-
                          gs://managed-gemini-files/.../file_example123-sample.mp4
                      created_at:
                        type: integer
                        format: int64
                        example: 1783580035
                      expires_at:
                        type: integer
                        format: int64
                        example: 1783666435
        '401':
          description: Missing or invalid LinkModel API key.
        '404':
          description: File identifier not found or not accessible to this account.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````