Gemini 3 Pro Image Preview
集成
gemini-3-pro-image-preview
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/gemini-3-pro-image-preview?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}'
# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY"
const API = "https://api.doitong.com/v1";
const headers = {
"Authorization": "Bearer " + process.env.DOITONG_API_KEY,
"Content-Type": "application/json",
};
// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/gemini-3-pro-image-preview?wait=20", {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);
// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
import os
import requests
API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}
payload = {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
}
# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/gemini-3-pro-image-preview", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])
# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/zh/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.com/v1/mcp \
--header "Authorization: Bearer $DOITONG_API_KEY"
# 2. Your agent calls the "run" tool with:
{
"model_id": "gemini-3-pro-image-preview",
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}
}
通过 Doitong API 调用 Gemini 3 Pro Image Preview 模型(gemini-3-pro-image-preview)。智能体文档:https://doitong.com/zh/developers/models/gemini-3-pro-image-preview.md
POST https://api.doitong.com/v1/run/gemini-3-pro-image-preview?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json
{
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}
如果响应状态为 "queued" 或 "running",请轮询 GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20,直到状态变为 "succeeded";文件位于 outputs[].url。使用相同请求体 POST https://api.doitong.com/v1/quote/gemini-3-pro-image-preview,可在运行前返回确切价格。
此请求: $0.15 150 API 积分 在此页面运行
你的新 API 密钥。 它仅在此时显示,并且已填入下方的代码和 API 密钥字段中。请妥善保密:切勿将其放入在浏览器中运行的代码。
在 Doitong 上制作
Doitong 社区使用 Gemini 3 Pro Image Preview 制作的公开作品。一键复用提示词。
Full-body character reference of the character shown in the reference film frame: exactly the same design, shape, proportions, colors, materials, wear and markings. Standing, front three-quarter view, the whole figure in frame, neutral dark studio background, soft even light, photorealistic,...
Нужен кадр вот к этой секунде 00:04 без текста Используй референс только при необходимости, если он есть в кадре по этому сценарию Вот подробный сценарий вирального ролика (Reels/TikTok/Shorts), созданный по всем вашим вводным. **Общая концепция:** Эстетика «old money» и современной роскоши...
Full-body character reference of the character shown in the reference film frame: exactly the same design, shape, proportions, colors, materials, wear and markings. Standing, front three-quarter view, the whole figure in frame, neutral dark studio background, soft even light, photorealistic,...
Art style: 3D Pixar, highly detailed, vibrant colors, expr.... 3D Pixar style. A dark, snowy city street at night. The banana man looks incredibly guilty and sad as he places the two tiny baby grapes into a metal trash can. Heavy snow is falling. Somber atmosphere....
Art style: 3D Pixar. Young man Dmitry looking exhausted, split image: left side dull grayscale park walk, right side vibrant exploding phone screen and glowing overloaded dopamine receptors in brain overlay. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT (this is the authoritative...
Strong rule: style --- Whimsical 3D Illustration ---. Strong rule: style --- Whimsical 3D Illustration ---. Strong rule: style --- Whimsical 3D Illustration ---. Strong rule: style --- Whimsical 3D Illustration ---. Очаровательная антропоморфная овечка девочка в полный рост, тело удлиненное и...
Strong rule: style --- Whimsical 3D Illustration ---. Strong rule: style --- Whimsical 3D Illustration ---. Strong rule: style --- Whimsical 3D Illustration ---. Милая женственная антропоморфная овечка в полный рост, высокая стройная фигура, пушистая светлая шерсть, длинная шея без без шерсти,...
Strong rule: style --- Whimsical 3D Illustration ---. Милая антропоморфная овечка в полный рост, длинная длинная стройная фигура, пушистая кремово-белая кудрявая шерсть, длинная тонкая тонкая шея как палочка без шерсти лысая, большие висячие ушки, светло-коричневая мордочка с мягкими округлыми...
Art style: Whimsical 3D Illustration. Three anthropomorphic sheep teachers sitting under a massive, ancient oak tree in a sunny meadow. Delovushka, wearing a neat grey vest, holds a small notepad and pencil. A smartphone sits on a nearby tree stump. High-quality 3D animation style, warm golden...
[Lighting: cinematic] Art style: Кинематографический, фотореалистичный. рука парня, решительно тянется к экрану монитора своего компьютера и нажимает кнопку 'Включить SILA VPN' на экране. В момент клика вся комната заливается мощным, чистым синим светом. Амогусы с ножами в ужасе отлетают от окон...
Recreate this exact cinematic film shot from the reference image as a brand-new photorealistic render. Match exactly: the composition and framing, the camera angle and lens, the lighting direction, the light rays and haze, the color grade, and the design of every object and character, including...
Recreate this exact cinematic film shot from the reference image as a brand-new photorealistic render. Match exactly: the composition and framing, the camera angle and lens, the lighting direction, the light rays and haze, the color grade, and the design of every object and character, including...
Art style: Cinematic, slightly gritty, realistic photography. Света с сосредоточенным видом пытается прикрепить тонкую прядь к густым волосам Ани. Капсула выглядит огромной и кривой . Аня сидит на табуретке, листая ленту в телефоне. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT...
Art style: Cinematic, slightly gritty, realistic photography. В дверях кухни появляется Аня. Она с трудом протискивается в узкий проход. Ее очень густое каре буквально стоит шапкой. Света оглядывает ее с сомнением, но быстро кивает. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT...
Art style: Cinematic, slightly gritty, realistic photography. Аня на кухне протягивает Свете мятую купюру в 100 рублей. Света берет деньги с видом великого мастера, принимающего должное. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT (this is the authoritative rendering directive...
Art style: Cinematic, slightly gritty, realistic photography. Вид сзади на голову Ани. Четко видна ровная линия ее густого каре, а из-под нее сиротливо свисает мало тонких,длинные пряди. Выглядит это максимально нелепо. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT (this is the...
构建请求
控件根据模型架构生成。更改控件时,代码和价格会同步更新。
/run/gemini-3-pro-image-preview?wait=20
报价 → $0.15
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/gemini-3-pro-image-preview?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}'
# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY"
const API = "https://api.doitong.com/v1";
const headers = {
"Authorization": "Bearer " + process.env.DOITONG_API_KEY,
"Content-Type": "application/json",
};
// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/gemini-3-pro-image-preview?wait=20", {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);
// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
import os
import requests
API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}
payload = {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
}
# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/gemini-3-pro-image-preview", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])
# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "run",
"arguments": {
"model_id": "gemini-3-pro-image-preview",
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
},
"wait_seconds": 20
}
}
}
关于 Gemini 3 Pro Image Preview
根据最多 50000 个字符的 `prompt` 生成 1 到 4 张图像。`resolution` 为 1K、2K 或 4K,`aspect_ratio` 提供 auto 以及九种固定比例。支持 `system_prompt` 和 `enable_web_search`,输出格式可为 PNG、JPEG 或 WebP。
参数
发送规范名称或原生名称之一,不要同时发送两者。 规范名称
prompt必填
num_images可选
num_outputs
seed可选
aspect_ratio可选
output_format可选
safety_tolerance可选
system_prompt可选
resolution可选
limit_generations可选
enable_web_search可选
输出
{
"id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
"object": "request",
"model": "gemini-3-pro-image-preview",
"status": "succeeded",
"created_at": "2026-10-20T12:00:00Z",
"started_at": "2026-10-20T12:00:02Z",
"completed_at": "2026-10-20T12:00:09Z",
"queue_position": null,
"cost": {
"credits": 150,
"usd": "0.15",
"charged": 150,
"refunded": 0
},
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
},
"output": {
"images": [
{
"url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
"content_type": "image/jpeg",
"file_name": "0-output.jpeg",
"file_size": 1843200,
"width": 1024,
"height": 768
}
],
"description": "string"
},
"outputs": [
{
"type": "image",
"url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
"content_type": "image/jpeg",
"file_size": 1843200,
"width": 1024,
"height": 768,
"stored": true
}
],
"error": null,
"metrics": {
"inference_seconds": 6.8
},
"urls": {
"self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
"cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
}
}
输出字段
- images
- array of object {url, content_type, file_name, file_size, width, height}模型生成的图像。
- description
- string随生成图像附带的描述。
其他 Gemini 3 Pro Image Preview 变体
更多模型:文生图
对于 AI 代理:此页面的 Markdown 版本位于 https://doitong.com/zh/developers/models/gemini-3-pro-image-preview.md. 所有模型和指南: https://doitong.com/developers/llms.txt







