Gemini Media Recognition

POST

/v1beta/models/{model}:generateContent

Gemini image, PDF, audio, and video recognition request.

Note: Only Base64 uploads through inlineData are supported for images, PDFs, audio, and video. fileData.fileUri and the File API are not supported.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Body Params application/json

{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "Tell me about this instrument"
                },
                {
                    "inlineData": {
                        "mimeType": "image/jpeg",
                        "data": "Imagebase64"
                    }
                }
            ]
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1beta/models/:generateContent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "Tell me about this instrument"
                },
                {
                    "inlineData": {
                        "mimeType": "image/jpeg",
                        "data": "Imagebase64"
                    }
                }
            ]
        }
    ]
}'

Responses

🟢200Success

application/json

Success

Bodyapplication/json

Example

{
    "candidates": [
        {
            "content": {
                "role": "string",
                "parts": [
                    {}
                ]
            },
            "finishReason": "string",
            "safetyRatings": [
                {}
            ]
        }
    ],
    "usageMetadata": {
        "promptTokenCount": 0,
        "candidatesTokenCount": 0,
        "totalTokenCount": 0
    }
}

Modified at 2026-05-23 05:25:16

Gemini Text Chat

Native Claude Format