Skip to main content
POST
/
v3
/
gemini-3.1-flash-image-text-to-image
Gemini 3.1 Flash Image Generation
curl --request POST \
  --url https://api.highwayapi.ai/v3/gemini-3.1-flash-image-text-to-image \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "size": "<string>",
  "google": {
    "web_search": true,
    "image_search": true
  },
  "prompt": "<string>",
  "aspect_ratio": "<string>",
  "output_format": "<string>"
}
'
{
  "image_urls": [
    {}
  ],
  "grounding_metadata": {}
}
Generate images from text prompts using the Gemini 3.1 Flash Image Preview model. Supports configurable image size, aspect ratio, and thinking depth for higher-quality generation results.

​
Request Headers

​
Content-Type
string
required
Enum value: application/json
​
Authorization
string
required
Bearer authentication format: Bearer {{API key}}.

​
Request Body

​
size
string
default:"1K"
Pixel dimensions of the output image (width*height). 0.5K (512px) is only available for Gemini 3.1 Flash.Available values: 0.5K, 1K, 2K, 4K
​
google
object
Google Search options
​
prompt
string
required
Text prompt describing the image to generate
​
aspect_ratio
string
default:"1:1"
Aspect ratio of the generated image.Available values: 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9
​
output_format
string
default:"image/png"
MIME type of the output image. Supports PNG and JPEG formats.Available values: image/png, image/jpeg

​
Response Information

​
image_urls
array
required
List of generated image URLs
​
grounding_metadata
object
Model grounding metadata. Returned when Google server-side tools (such as Search) are invoked. Note: Tool invocation depends on Google. Enabling the parameter does not necessarily trigger a tool call 100% of the time.