v1beta (Official Format - Text-to-Image)

POST

/v1beta/models/{model}:generateContent

From Google's gemini-2.5-flash-image model
Original Google documentation: https://ai.google.dev/gemini-api/docs/image-generation
Note: As a preview model, it is recommended to explicitly specify "output image", otherwise you may only get text.

We at 302 have made 2 optimizations to this endpoint:
1.
Support for returning url or raw bs64 data
2.
Support for editing images by passing in image_url

Pricing: Input 0.3 PTC/1M Tokens Output 30 PTC/1M Tokens

Request

Path Params

Query Params

Header Params

Body Params application/json

Example

{
  "contents": [
    {
      "parts": [
        {
          "text": "Hi, can you create a 3d rendered image of a pig with wings and a top hat flying over a happy futuristic scifi city with lots of greenery?"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ]
  }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/v1/v1beta/models/gemini-2.5-flash-image-preview:generateContent?response_format' \
--header 'x-goog-api-key: sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--header 'Content-Type: application/json' \
--data-raw '{
  "contents": [
    {
      "parts": [
        {
          "text": "Hi, can you create a 3d rendered image of a pig with wings and a top hat flying over a happy futuristic scifi city with lots of greenery?"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ]
  }
}'

Responses

🟢200OK

application/json

Body

Example

{
    "completed_at": "",
    "created_at": "",
    "error": "",
    "id": "",
    "model": "",
    "output": "",
    "started_at": "",
    "status": ""
}

Modified at 2025-09-03 02:29:09

v1beta（Official Format - Chat）

v1beta (Official Format - Image Editing)