Gemini 3.1 Flash

Google Gemini 3.1 Flash image API reference. Fast, high-quality image generation and editing. Best balance of speed and quality for production use.

Generate Image

POST

/v1/images/gemini/3.1/flash/generate/

Generate images from a text prompt. Gemini 3.1 Flash offers resolution-based pricing from 512px to 4K, extended aspect ratios including extreme formats like 1:8 and 8:1, and batch generation of up to 4 images.

Request

curl -X POST https://api.3daistudio.com/v1/images/gemini/3.1/flash/generate/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a minimalist logo design on white background",
    "output_format": "png",
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "num_images": 1
  }'

Response

{
  "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "created_at": "2026-02-25T12:00:00Z"
}

Generate Parameters

Parameter	Type	Required	Description
prompt	string	Yes	Text description of the image to generate.
output_format	string	No	"png", "jpeg", or "webp". Default: "png".
aspect_ratio	string	No	"auto", "21:9", "16:9", "3:2", "4:3", "5:4", "1:1", "4:5", "3:4", "2:3", "9:16", "1:4", "4:1", "1:8", or "8:1". Default: "auto".
resolution	string	No	"512px", "1K", "2K", or "4K". Default: "1K". Cost varies by resolution.
num_images	integer	No	Number of images (1 to 4). Default: 1. Credits multiply accordingly.

Edit Image

POST

/v1/images/gemini/3.1/flash/edit/

Edit existing images with natural-language instructions. Provide one or more base64-encoded source images and a text prompt describing the desired changes.

Request

curl -X POST https://api.3daistudio.com/v1/images/gemini/3.1/flash/edit/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Remove the background and make it transparent",
    "images": ["data:image/png;base64,iVBOR..."],
    "output_format": "png",
    "resolution": "1K"
  }'

Response

{
  "task_id": "f7e8d9c0-b1a2-3456-7890-abcdef012345",
  "created_at": "2026-02-25T12:00:00Z"
}

Edit Parameters

Parameter	Type	Required	Description
prompt	string	Yes	Text instruction describing the edit to apply.
images	array	Yes	Array of 1 to 14 base64-encoded source images (data:image/...;base64,...).
output_format	string	No	"png", "jpeg", or "webp". Default: "png".
aspect_ratio	string	No	Output aspect ratio. Supports all 15 options including extreme ratios. Default: "auto".
resolution	string	No	"512px", "1K", "2K", or "4K". Default: "1K".
num_images	integer	No	Number of output images (1 to 4). Default: 1.

Checking Status

GET

/v1/generation-request/<task_id>/status/

Poll this endpoint with the task_id from the submit response. When status is "FINISHED", the results array contains your generated or edited images with download URLs and thumbnails. Results expire after 24 hours.

Request

curl https://api.3daistudio.com/v1/generation-request/YOUR_TASK_ID/status/ \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "status": "FINISHED",
  "progress": 100,
  "results": [
    {
      "asset_url": "https://cdn.3daistudio.com/images/img_001.png",
      "asset": "https://storage.3daistudio.com/assets/img_001.png",
      "asset_type": "IMAGE",
      "thumbnail": "https://storage.3daistudio.com/thumbnails/img_001.png"
    }
  ]
}

Credit Costs

Gemini 3.1 Flash uses resolution-based pricing. Credits are calculated as cost per image multiplied by the number of images requested.

Resolution	Per Image
512px	10 credits
1K	15 credits
2K	20 credits
4K	25 credits

Processing Times

Image generation typically takes 30–60 seconds per image. Editing takes a similar amount of time depending on the complexity of the edit. Higher resolutions and batch requests may take longer.

Errors

Common errors for Gemini 3.1 Flash image endpoints.

Status	Error Code	Description
402	insufficient_credits	Not enough credits. Top up your wallet.
429	rate_limited	Rate limit exceeded. Wait and retry.
400	validation_failed	Missing or invalid parameters.