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 制作的公开作品。一键复用提示词。
[Lighting: cinematic] Art style: Кинематографический, фотореалистичный. Крупный план экрана компьютера. По экрану бегут строки фейковых данных: IP-адрес, город, личная информация. Поверх изображения — красный 'сканирующий' луч и мигающие символы тревоги. В отражении экрана видны амогусы с ножами...
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...
Strong rule: style --- Whimsical 3D Illustration ---. Strong rule: style --- Whimsical 3D Illustration ---. Strong rule: style --- Whimsical 3D Illustration ---. Милая антропоморфная овечка в полный рост, длинная длинная стройная фигура, фигура удлиненная, пушистая кремово-белая кудрявая шерсть,...
[Lighting: cinematic] Art style: Кинематографический, фотореалистичный. Крупный план руки парня, которая решительно нажимает кнопку 'Включить SILA VPN' на экране. В момент клика вся комната заливается мощным, чистым синим светом. Амогусы в ужасе отлетают от окон и дверей, их 2D-формы искажаются....
[Lighting: cinematic] Art style: Кинематографический, фотореалистичный. Та же комната, но теперь она залита спокойным синим светом от монитора. Парень расслабленно сидит в кресле и энергетик монстер. За окном видно, как побежденные амогусы с ножами грустно уходят. Стиль - полный реализм,...
Нужен кадр вот к этой секунде 00:08 без снега пусть будет лето, без текста Используй референс только при необходимости, если он есть в кадре по этому сценарию Вот подробный сценарий вирального музыкального клипа. **Стиль и эстетика:** Яркая, насыщенная цветовая палитра в духе колоризованного...
Нужен кадр вот к этой секунде 00:48 без снега пусть будет лето, без текста Используй референс только при необходимости, если он есть в кадре по этому сценарию Вот подробный сценарий вирального музыкального клипа. **Стиль и эстетика:** Яркая, насыщенная цветовая палитра в духе колоризованного...
Use the woman from the reference photo as the main character, preserve her facial identity, natural facial features, realistic skin texture, eyes, lips, eyebrows and face shape. Create a magical cinematic summer fantasy scene. The woman is sitting or lying on soft green grass in a beautiful...
Single isolated character reference image. EXACTLY ONE character, alone — no other people, no background scene, no story. Full or three-quarter body, centered on a clean plain neutral studio backdrop (soft solid color). Casting / character-sheet look. Character: Маленькая собака, пушистый...
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...
Strong rule: style --- Кинематографичный, макро-съемка, меланхоличный ... ---. Обычная комнатная муха, но с большими, выразительными и грустными фасеточными глазами. Ее крылья имеют нежную, полупрозрачную текстуру. Акцент на том, чтобы она выглядела детализированной и трогательной, а не просто...
Strong rule: style --- 3D Pixar ---. Крупный план на лице Марка, который в ужасе смотрит, как на него с трёх сторон медленно надвигаются стилизованные гигантские фигуры: треснувшее пополам обручальное кольцо, разъярённый кассовый аппарат с зубами и стопка счетов, превратившаяся в монстра. Стиль —...
Art style: Кинематографичный, макро-съемка, меланхоличный .... Комната почти погрузилась во тьму. Муха — лишь крошечный темный силуэт на фоне последних отблесков заката в окне. Финальный кадр, полный одиночества. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT (this is the...
Art style: Кинематографичный, макро-съемка, меланхоличный .... Солнце начинает садиться. Муха сидит неподвижно на стекле. В стекле видно ее слабое отражение, наложенное на изображение угасающего сада. Настроение смирения и тихой грусти. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE...
Art style: Кинематографичный, макро-съемка, меланхоличный .... Капля дождя медленно стекает по внешней стороне окна. Муха сидит на внутренней стороне и наблюдает за ней. Мир за окном искажается и переливается в этой капле. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT (this is...
Art style: Кинематографичный, макро-съемка, меланхоличный .... Крупный план: муха бьется о прозрачное стекло. Видны вибрации на ее крыльях и легкие искажения на стекле в месте удара. Свет от окна создает сильный контраст, почти силуэт. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE...
构建请求
控件根据模型架构生成。更改控件时,代码和价格会同步更新。
/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







