Gemini 3.1 Flash Image Preview
یکپارچهسازی
gemini-3.1-flash-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.1-flash-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.1-flash-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.1-flash-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/fa/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.1-flash-image-preview",
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}
}
مدل Gemini 3.1 Flash Image Preview (gemini-3.1-flash-image-preview) را از طریق Doitong API فراخوانی کنید. مستندات عاملها: https://doitong.com/fa/developers/models/gemini-3.1-flash-image-preview.md
POST https://api.doitong.com/v1/run/gemini-3.1-flash-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.1-flash-image-preview با همان بدنه، قیمت دقیق را پیش از اجرا برمیگرداند.
این درخواست: $۰٫۰۸ ۸۰ اعتبار API اجرای آن در این صفحه
کلید API جدید شما. این کلید فقط همین حالا نمایش داده میشود و از قبل در کد و فیلد کلید API زیر قرار گرفته است. آن را محرمانه نگه دارید: هرگز آن را در کدی که در مرورگر اجرا میشود قرار ندهید.
ساختهشده در Doitong
آثار عمومی ساختهشده با Gemini 3.1 Flash Image Preview توسط جامعه Doitong. یک پرامپت را با یک کلیک دوباره استفاده کنید.
Art style: Cinematic Realistic. Интерьер роскошного банкетного зала в загородном особняке, заполненного нарядными гостями. Повсюду видны хрустальные бокалы с шампанским. Освещение яркое, с динамичными вспышками света, создающими атмосферу праздника. В центре композиции — Стася (желтые волосы и...
Art style: Cinematic Realistic. Макросъемка ладони Стаси, скрытой за ее спиной, в которой она сжимает современный смартфон. Экран телефона ярко вспыхивает в полумраке, отображая текстовое сообщение от неизвестного номера. Текст сообщения четкий и контрастный на темном фоне дисплея. На заднем...
Art style: Cinematic Realistic. A clearly recognizable likeness of Подруга — keep their real face shape, skin tone, hairstyle, build and any signature look (hair, kit, number). Девушка модельной внешности с ярким макияжем и ослепительной улыбкой. У нее платиновые волосы, собранные в высокий...
Art style: 3D Pixar. Luna abriendo la última carta con dedos temblorosos, una flor seca cayendo de su interior, expresión de asombro en su rostro, pétalos y cartas alrededor, composición vertical con ángulo medio, luz suave dorada iluminando la carta y la flor, atmósfera reveladora...
Art style: 3D Pixar. Salón con una luz suave y difusa. Él está de pie junto a Ella, ofreciéndole una taza de café en un gesto de atención inusual. Ella está sentada, mirando hacia el frente sin tomar la taza, con una distancia emocional evidente. Los colores son ocres y apagados. El teléfono de...
Art style: 3D Pixar. Горизонтальний крупний план нижньої частини дверей та порога. Чітко видно випадаючий з нижньої частини дверей ущільнювач, типу гільотина,. Підлога вкрита м'яким ковроліном нейтрального кольору. Світло відбивається від латунних деталей фурнітури. Атмосфера спокою та...
Art style: Cinematográfico realista. Marcos de rodillas frente a Elena, suplicando. Elena lo mira con compasión pero sin amor. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT (this is the authoritative rendering directive — it overrides any style wording elsewhere in the prompt):...
Art style: Cinematic Realistic. Крупный план мужской руки в черном рукаве смокинга, грубо и сильно сжимающей тонкое женское запястье. На фоне видна часть лица Артура с неестественной, застывшей улыбкой, адресованной гостям. Кожа на запястье Стаси бледнеет от давления. Освещение становится более...
Art style: Cinematic Realistic. Regreso al restaurante elegante. Un plano de detalle desde arriba muestra la mano de Elena sacando una tarjeta de crédito negra de su bolso y colocándola con firmeza sobre la cuenta de cuero. La iluminación vuelve a ser la luz cálida de las velas del inicio. El...
Art style: 3D Pixar. Cocina luminosa por la mañana. Ella está de espaldas cocinando en silencio, con movimientos mecánicos y tranquilos. Él está sentado a la mesa del comedor, relajado, con una sonrisa de complacencia. La atmósfera parece pacífica pero es artificialmente fría. Colores claros y...
Art style: 3D Pixar. Вид с низкой точки: Тукки стоит перед свежим снежным завалом, который полностью перекрыл узкую тропинку между ледяными скалами. Лисенок выглядит растерянным, его уши прижаты к голове. Олень стоит рядом, его массивное тело надежно загораживает путь холодному ветру, создавая...
Art style: Cinematográfico realista. Primer plano de la cara de Marcos, desencajado y sin palabras. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT (this is the authoritative rendering directive — it overrides any style wording elsewhere in the prompt): Render this image entirely...
Art style: 3D Pixar. Full-length view, the entire figure visible from head to feet, standing upright and centered — Hryusha, a friendly little pig, a cheerful young piglet with soft velvety rosy-pink skin, plump rounded cheeks and a broad upturned snout with two little nostrils. He has small...
Art style: Cinematic Realistic. A clearly recognizable likeness of Игорь — keep their real face shape, skin tone, hairstyle, build and any signature look (hair, kit, number). Мужчина средних лет с благородной внешностью, легкая щетина на лице придает ему мужественности. У него глубоко посаженные...
Art style: 3D Pixar. A clearly recognizable likeness of Ella — keep their real face shape, skin tone, hairstyle, build and any signature look (hair, kit, number). Mujer de unos 30 años, de rasgos suaves pero mirada profunda y expresiva. Su cabello es castaño oscuro, lacio y cae sobre sus hombros....
Art style: Cinematográfico realista. Marcos le entrega una taza de café a Elena, quien está sentada en el sofá. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ FINAL STYLE ENFORCEMENT (this is the authoritative rendering directive — it overrides any style wording elsewhere in the prompt): Render this...
ساخت درخواست
کنترلها از شِمای مدل تولید میشوند. با تغییر آنها، کد و قیمت بهروزرسانی میشوند.
/run/gemini-3.1-flash-image-preview?wait=20
قیمت → $۰٫۰۸
# 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.1-flash-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.1-flash-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.1-flash-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.1-flash-image-preview",
"input": {
"prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
},
"wait_seconds": 20
}
}
}
اجرای این درخواست
کلید شما در این مرورگر باقی میماند: فقط به Doitong API ارسال میشود و فقط در صورت فعالکردن گزینه «یادآوری»، در localStorage ذخیره میشود. دریافت کلید API
درباره Gemini 3.1 Flash Image Preview
از یک `prompt` تصویر تولید میکند؛ `resolution` میتواند 0.5K، 1K، 2K یا 4K باشد و نسبتهای تصویر شامل نسبتهای بسیار گستردهای مانند 8:1 و 1:8 هستند. `system_prompt`، `enable_web_search` و `thinking_level` اختیاری (minimal یا high) تولید را شکل میدهند. 1 تا 4 تصویر در PNG، JPEG یا WebP تولید میکند.
پارامترها
نام استاندارد یا نام بومی را ارسال کنید، نه هر دو. نامهای استاندارد
promptالزامی
num_imagesاختیاری
num_outputs
seedاختیاری
aspect_ratioاختیاری
output_formatاختیاری
safety_toleranceاختیاری
system_promptاختیاری
resolutionاختیاری
limit_generationsاختیاری
enable_web_searchاختیاری
thinking_levelاختیاری
خروجی
{
"id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
"object": "request",
"model": "gemini-3.1-flash-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": 80,
"usd": "0.08",
"charged": 80,
"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.1 Flash Image Preview
مدلهای بیشتر: متن به تصویر
برای عاملهای هوش مصنوعی: این صفحه بهصورت Markdown در دسترس است https://doitong.com/fa/developers/models/gemini-3.1-flash-image-preview.md. همه مدلها و راهنماها: https://doitong.com/developers/llms.txt







