Inputlive schema
参考图 URLreference_image_urls
No test requests yet. Send your first request.
Sign in to run this model with your own API key. Sign in →
Google/gemini-3-pro-image
谷歌最强大的图像生成模型
OperationalText to ImageImage to Image-50%vs officialPriced by usage dimensionsCommercial useData privacy
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_tokens
gemini-3-pro-image$1.00per 1M2/1M
Criteriacompletion_tokens
gemini-3-pro-image$60.00per 1M120/1M
Criteriathoughts_tokens
gemini-3-pro-image$6.00per 1M12/1M
API
POST
/v1beta/models/gemini-3-pro-image:generateContentconst 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-pro-image",
"input": {
"prompt": "修复键盘顶端斑驳痕迹，其他内容不变",
"reference_image_urls": [
"https://example.com/reference.png"
],
"image_size": "1K",
"aspect_ratio": "1:1",
"mime_type": "image/png",
"response_modalities": [
"TEXT",
"IMAGE"
],
"seed": 12345,
"callback_url": "https://example.com/webhook"
}
};
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-pro-image
谷歌最强大的图像生成模型
Why Choose This?
- Text-to-image generation
- Turns natural-language prompts into finished images.
- Pay per token
- $1.00 per 1M input tokens and $60.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 |
|---|---|---|
promptstring | Required | Text description of what to generate. |
reference_image_urlsarray | Optional | Reference images to guide the result. |
image_sizestring | Optional | Output image size. Default: 1K. |
aspect_ratiostring | Optional | Output aspect ratio. |
mime_typeenum | Optional | 参考图 MIME Options: image/png, image/jpeg, image/webp. Default: image/png. |
response_modalitiesarray | Optional | 响应模态 |
seedinteger | Optional | Random seed. Reuse it to reproduce a result. |
callback_urlstring | Optional | 回调地址 |
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-pro-image:generateContent with the model ID gemini-3-pro-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 | $1.00 per 1M | |
| completion_tokens | $60.00 per 1M | |
| thoughts_tokens | $6.00 per 1M |
That is 50% below the official list price.
Example: a request with 10,000 input tokens and 1,000 output tokens costs about $0.07.
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.
Related models
- Gemini-3.1-flash-lite-image —
gemini-3-1-flash-lite-image - gemini-3.1-flash-image —
gemini-3-1-flash-image - Nano Banana 2 —
nano-banana-2 - Nano Banana Pro —
nano-banana-pro - Veo 3.1 —
veo-3-1
Browse all image modelsBrowse API Market
FAQ
What is gemini-3-pro-image?
谷歌最强大的图像生成模型
How do I call the gemini-3-pro-image API?
Send POST /v1beta/models/gemini-3-pro-image:generateContent with the model ID gemini-3-pro-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.
About gemini-3-pro-image on dreamtoai
谷歌最强大的图像生成模型