OpenAI Chat Format

POST

/v1/chat/completions

Gemini ImageGeneration

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

Example

{
  "model": "gemini-3-pro-image-preview",
  "stream": false,
  "messages": [
    {
      "role": "user",
      "content": "draw a cat"
    }
  ],
  "extra_body": {
    "google": {
      "image_config": {
        "aspect_ratio": "16:9",
        "image_size": "2K"
      }
    }
  }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/chat/completions' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "model": "gemini-3-pro-image-preview",
  "stream": false,
  "messages": [
    {
      "role": "user",
      "content": "draw a cat"
    }
  ],
  "extra_body": {
    "google": {
      "image_config": {
        "aspect_ratio": "16:9",
        "image_size": "2K"
      }
    }
  }
}'

Responses

🟢200Success

application/json

Success

Bodyapplication/json

Example

{
    "id": "chatcmpl-20251211160744809365000fdOhL0KY",
    "model": "gemini-3-pro-image-preview",
    "object": "chat.completion",
    "created": 1765440499,
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "![image](data:image/jpeg;base64,Imagebase64)"
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 4,
        "completion_tokens": 1359,
        "total_tokens": 1363
    }
}

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

Native Gemini Format

Create Video