Gemini Native Images

Gemini native image and multimodal requests do not use /v1/images/generations. Gemini platform groups should use /v1beta/models... paths and send Gemini native request bodies.

List Models

Item	Value
Method	GET
Path	/v1beta/models
Authentication	Authorization: Bearer YOUR_API_KEY
Platform requirement	Gemini platform group

curl https://llmapi.site/v1beta/models \
  -H 'Authorization: Bearer YOUR_API_KEY'

The response returns models available to the current Gemini group. Actual availability depends on group accounts, model mapping, account status, and upstream quota.

Get a Model

Item	Value
Method	GET
Path	/v1beta/models/{model}

curl https://llmapi.site/v1beta/models/gemini-2.5-flash-image \
  -H 'Authorization: Bearer YOUR_API_KEY'

Generate Images or Multimodal Content

Item	Value
Method	POST
Path	/v1beta/models/{model}:generateContent
Content-Type	application/json
Authentication	Authorization: Bearer YOUR_API_KEY

Path parameters:

Parameter	Type	Required	Description
model	string	Yes	Gemini native model name, such as gemini-2.5-flash-image.

Body parameters:

Parameter	Type	Required	Description
contents	array	Yes	Gemini native content array. Text and image inputs are placed in parts.
systemInstruction	object	No	Gemini native system instruction.
generationConfig	object	No	Gemini native generation config. Image-output models usually require responseModalities according to upstream capability.
safetySettings	array	No	Gemini native safety settings, forwarded when supported upstream.

Text-to-image example:

curl https://llmapi.site/v1beta/models/gemini-2.5-flash-image:generateContent \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "Generate a clean studio product image of a matte black water bottle on a white background." }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["IMAGE"]
    }
  }'

Multimodal example with an input image:

curl https://llmapi.site/v1beta/models/gemini-2.5-flash-image:generateContent \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "Create a new product image using this object, with a bright studio background." },
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "BASE64_IMAGE_DATA"
            }
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["IMAGE"]
    }
  }'

Streaming

POST /v1beta/models/{model}:streamGenerateContent?alt=sse

curl -N 'https://llmapi.site/v1beta/models/gemini-2.5-flash-image:streamGenerateContent?alt=sse' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "Generate a square product image of a ceramic coffee cup." }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["IMAGE"]
    }
  }'

Common Errors

Error	Meaning
API key group platform is not gemini	The current API key does not belong to a Gemini platform group.
No available Gemini accounts	The group has no available Gemini account, or no account supports the requested model.
Upstream 4xx/5xx	Request body, model, quota, or upstream account capability does not satisfy the Gemini native API.