Inputlive schema

提示词*prompt

参考图 URLreference_image_urls

Upload images (multiple allowed)

参考图reference_images

Upload images (multiple allowed)

图片比例aspect_ratio

No test requests yet. Send your first request.

Output

Run the form on the left. Results, polling status and cURL appear under the form.

Pricing

This model is priced by the usage dimensions listed here. Compare all pricing.

List prices in USD. Your effective price also depends on the billing group attached to your API key.

Criteriaprompt_tokensgemini-3.1-flash-lite-image

$0.10per 1M~~0.25/1M~~

Criteriacompletion_tokensgemini-3.1-flash-lite-image

$12.00per 1M~~30/1M~~

Criteriathoughts_tokensgemini-3.1-flash-lite-image

$0.60per 1M~~1.5/1M~~

API

POST/v1beta/models/gemini-3.1-flash-lite-image:generateContent

const BASE_URL = "https://api.dreamtoai.com";
const API_KEY = process.env.MIX_API_KEY;

const headers = {
  "Authorization": `Bearer ${API_KEY}`,
  "Content-Type": "application/json",
};

const payload = {
  "model": "gemini-3.1-flash-lite-image",
  "input": {
    "prompt": "生成一张产品海报，白色背景，商业摄影风格",
    "image_url": "https://example.com/input.png",
    "reference_image_urls": [
      "https://example.com/reference.png"
    ],
    "reference_images": [
      "https://example.com/reference.png"
    ],
    "mask": "https://example.com/mask.png",
    "size": "2752x1536",
    "quality": "medium",
    "output_format": "png",
    "response_format": "url",
    "background": "auto",
    "n": 1,
    "user": "user-123",
    "style": "Describe the output you want",
    "aspect_ratio": "1:1、3:2、2:3、3:4、4:3、4:5、5:4、9:16、16:9"
  }
};

const submit = await fetch(`${BASE_URL}/v1/jobs`, {
  method: "POST",
  headers,
  body: JSON.stringify(payload),
}).then((r) => r.json());

const status = await fetch(`${BASE_URL}/v1/jobs/${submit.id}`, { headers })
  .then((r) => r.json());
console.log(status);

Create a key in Console → API Keys and replace the placeholder in the sample.

README

gemini-3.1-flash-lite-image

Why Choose This?

Text-to-image generation: Turns natural-language prompts into finished images.
Pay per token: $0.10 per 1M input tokens and $12.00 per 1M output tokens, with no subscription.
Works with your existing SDK: Call it in the Gemini format, so existing clients only need a new base URL and key.
One key for every model: The same API key works for every model on dreamtoai.

Parameters

Parameter	Required	Description
`prompt`string	Required	Text description of what to generate.
`image_url`image	Optional	Reference image to guide the result.
`reference_image_urls`array	Optional	Reference images to guide the result.
`reference_images`array	Optional	参考图
`mask`image	Optional	遮罩图
`size`string	Optional	Output image size.
`quality`enum	Optional	Output quality level. Options: `auto`, `low`, `medium`, `high`. Default: `auto`.
`output_format`enum	Optional	输出格式 Options: `png`, `jpeg`, `webp`.
`response_format`enum	Optional	Format of the returned result, such as a URL or base64 data. Options: `base64`, `url`.
`background`enum	Optional	背景 Options: `auto`, `transparent`, `opaque`.
`n`integer	Optional	Number of outputs to generate.
`user`string	Optional	终端用户标识
`style`string	Optional	风格
`aspect_ratio`string	Optional	Output aspect ratio. Default: `1:1`.

How to Use

Try it here first — Sign in and run the model in the playground above to check the output before you write code.
Create an API key — Open Console → API Keys and create a key. The same key works for every model.
Write your prompt — Describe the subject, style, composition and lighting you want.
Set optional parameters — Adjust the optional parameters listed above to control the output.
Send the request — Call POST /v1beta/models/gemini-3.1-flash-lite-image:generateContent with the model ID gemini-3.1-flash-lite-image.
Read the result — The generated output comes back in the response and the request is logged in the console.

Writing Effective Prompts

The model reads a prompt like a creative brief. Name the subject first, then add the details that matter.

1. Subject and action

Who or what is in the image, and what it is doing.

2. Style and medium

Photo, 3D render, watercolor or flat illustration. For photographic looks, name a lens or film stock.

3. Composition

Framing and viewpoint: close-up, wide shot, overhead, centered, rule of thirds.

4. Lighting and color

Golden hour, soft studio light, neon, a pastel palette, high contrast.

5. Text in the image

Put the exact words in quotes and say where they go.

A poster with the headline "OPEN LATE" in bold white letters across the top.

	Prompt
Weak	a coffee shop
Strong	A cozy corner coffee shop on a rainy evening, seen through the front window. Warm tungsten light inside, a barista pouring latte art, condensation on the glass, street reflections. 35mm photo, shallow depth of field, muted teal and amber palette.

Pricing

Billing item	Price	Official price
prompt_tokens	$0.10 per 1M	~~$0.25/1M~~
completion_tokens	$12.00 per 1M	~~$30.00/1M~~
thoughts_tokens	$0.60 per 1M	~~$1.50/1M~~

That is 60% below the official list price.

Example: a request with 10,000 input tokens and 1,000 output tokens costs about $0.01.

List prices in USD. Your effective price also depends on the billing group attached to your API key. Compare all pricing

Best Use Cases

Marketing and ads — Produce campaign visuals and ad variations in minutes.
E-commerce — Create product shots, lifestyle scenes and banners.
Concept art and storyboards — Explore characters, environments and scenes before production.
Social media content — Make on-brand images in square, portrait or landscape formats.
Design exploration — Try layouts, palettes and styles quickly.
Editorial illustration — Illustrate articles, newsletters and presentations.

Pro Tips

Generate a few variations of a promising prompt before refining the details.
Keep the subject in the first sentence; add style and lighting after it.
Put any text that should appear in the image in quotes.
Pick the aspect ratio for where the image will be used before generating.
Reuse the same seed, when the model offers one, to compare prompt changes fairly.

gemini-3.1-flash-image — gemini-3-1-flash-image
gemini-3-pro-image
Nano Banana 2 — nano-banana-2
Nano Banana Pro — nano-banana-pro
Veo 3.1 — veo-3-1

Browse all image models Browse API Market

FAQ

What is gemini-3.1-flash-lite-image?

gemini-3.1-flash-lite-image

How do I call the gemini-3.1-flash-lite-image API?

Send POST /v1beta/models/gemini-3.1-flash-lite-image:generateContent with the model ID gemini-3.1-flash-lite-image and your API key. Ready-to-run samples are in the API section above.

How is billing calculated?

Requests are billed at the prices listed above and charged to your wallet. Final cost depends on usage and the billing group attached to your API key.

Where do I get an API key?

Create one in Console → API Keys. The same key works for every model on the gateway.

Can I use the output commercially?

Yes. You can use what you generate in commercial projects, subject to the model provider’s terms.

Google/gemini-3.1-flash-lite-image

Inputlive schema

Output

Pricing

API

gemini-3.1-flash-lite-image

Why Choose This?

Parameters

How to Use

Writing Effective Prompts

1. Subject and action

2. Style and medium

3. Composition

4. Lighting and color

5. Text in the image

Pricing

Best Use Cases

Pro Tips

FAQ

About gemini-3.1-flash-lite-image on dreamtoai

Related models

Next steps