رفتن به محتوا

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://vit.doitong.com/api/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://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

این درخواست: ⁨‎$۰٫۱۵⁩ ۱۵۰ اعتبار API اجرای آن در این صفحه

دریافت کلید API
Google متن به تصویر خروجی 4Kحداکثر 4K #realism#typography

تبدیل متن به تصویر با Gemini 3 Pro Image در 1K، 2K یا 4K، با جست‌وجوی وب و پرامپت سیستمی اختیاری

Google · تصویر

اولین نتیجه شما اینجا قرار می‌گیرد

درخواست را در زیر بسازید و با کلید API خود اجرا کنید. خروجی‌ها در فضای ذخیره‌سازی ما کپی می‌شوند و برای همیشه یا به‌مدت ۷ روز رایگان نگه‌داری می‌شوند.

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

•الزامی 88 / 50000

دستورهای متنی برای تولید تصویر.

aspect_ratio پیش‌فرض 1:1

نسبت تصویر حاصل.

resolution پیش‌فرض 1K

وضوح تصویر خروجی.

num_images پیش‌فرض 1

تعداد تصاویر درخواستی برای تولید.

پیشرفته system_prompt · output_format · safety_tolerance · seed · limit_generations · enable_web_search
0 / 50000

راهنمای اختیاری مربوط به پرسونا و سبک خروجی در سطح درخواست که به Gemini به‌عنوان دستور سیستمی یا به ارائه‌دهندگان سازگار با OpenAI به‌عنوان پیام سیستمی ارسال می‌شود. اگر مقدار خالی باشد، چیزی برای این دستور ارسال نمی‌شود.

output_format پیش‌فرض png

قالب فایل تصویر نهایی.

safety_tolerance پیش‌فرض 4

تحمل تعدیل محتوا را بین کم‌محدودکننده‌ترین سطح، 6، و سخت‌گیرانه‌ترین سطح، 1، تنظیم می‌کند؛ سطح 1 بیشتر محتوا را مسدود می‌کند.

مقدار seed که تولید اعداد تصادفی را آغاز می‌کند.

POST /run/gemini-3-pro-image-preview?wait=20 قیمت → ⁨‎$۰٫۱۵⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/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://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

اجرای این درخواست

کلید شما در این مرورگر باقی می‌ماند: فقط به Doitong API ارسال می‌شود و فقط در صورت فعال‌کردن گزینه «یادآوری»، در localStorage ذخیره می‌شود. دریافت کلید API

درباره Gemini 3 Pro Image Preview

از یک `prompt` حداکثر 50000 نویسه‌ای، 1 تا 4 تصویر تولید می‌کند. `resolution` برابر 1K، 2K یا 4K است و `aspect_ratio` شامل auto به‌علاوه نه نسبت ثابت است. `system_prompt` و `enable_web_search` در دسترس‌اند و خروجی می‌تواند PNG، JPEG یا WebP باشد.

پارامترها

نام استاندارد یا نام بومی را ارسال کنید، نه هر دو. نام‌های استاندارد

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
≤ ۵۰٬۰۰۰ نویسه≥ ۳ نویسه
دستورهای متنی برای تولید تصویر.
num_imagesاختیاری num_outputs
نوعinteger
پیش‌فرض1
۱ – ۴
تعداد تصاویر درخواستی برای تولید.
seedاختیاری
نوعinteger | null
مقدار seed که تولید اعداد تصادفی را آغاز می‌کند.
aspect_ratioاختیاری
نوعenum
پیش‌فرض1:1
auto21:916:93:24:35:41:14:53:42:39:16
نسبت تصویر حاصل.
output_formatاختیاری
نوعenum
پیش‌فرضpng
jpegpngwebp
قالب فایل تصویر نهایی.
safety_toleranceاختیاری
نوعenum
پیش‌فرض4
123456
تحمل تعدیل محتوا را بین کم‌محدودکننده‌ترین سطح، 6، و سخت‌گیرانه‌ترین سطح، 1، تنظیم می‌کند؛ سطح 1 بیشتر محتوا را مسدود می‌کند.
system_promptاختیاری
نوعstring
پیش‌فرض
≤ ۵۰٬۰۰۰ نویسه
راهنمای اختیاری مربوط به پرسونا و سبک خروجی در سطح درخواست که به Gemini به‌عنوان دستور سیستمی یا به ارائه‌دهندگان سازگار با OpenAI به‌عنوان پیام سیستمی ارسال می‌شود. اگر مقدار خالی باشد، چیزی برای این دستور ارسال نمی‌شود.
resolutionاختیاری
نوعenum
پیش‌فرض1K
1K2K4K
وضوح تصویر خروجی.
limit_generationsاختیاری
نوعboolean
پیش‌فرضtrue
سقف آزمایشی تولید: فعال‌کردن `True` هر دستور مربوط به تعداد تصویر در پرامپت را بازنویسی می‌کند و هر دور پرامپت‌نویسی را به 1 تولید محدود می‌کند.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "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://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
فایل‌های شما، انتخاب شماهر outputs[].url کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
images
array of object {url, content_type, file_name, file_size, width, height}تصاویر تولیدشده توسط مدل.
description
stringتوضیح همراه تصاویر تولیدشده.

مدل‌های بیشتر: متن به تصویر

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/gemini-3-pro-image-preview.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt