رفتن به محتوا

Topaz Upscale Image Generative

یکپارچه‌سازی

شناسه مدل topaz/upscale/image/generative
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/topaz/upscale/image/generative?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

فایل‌هایی مانند نمونه: ⁨‎$۰٫۰۸⁩ ۸۰ اعتبار API · ≈ ⁨‎₽۸٫۴۴⁩ فایل‌های شما پیش از اجرا اندازه‌گیری می‌شوند اجرای آن در این صفحه

دریافت کلید API
Topaz Labs ارتقای وضوح #upscale#image

وضوح‌افزای مولد تصویر با مدل‌های متعدد، بهبود چهره و حالت Redefine هدایت‌شده با پرامپت

Topaz Labs · تصویر

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

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

ساخت درخواست

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

0 / 1024

متن راهنما برای ارتقای وضوح مولد، محدود به 1024 نویسه و فقط پشتیبانی‌شده توسط Redefine.

•الزامی image_url
یک فایل بیندازید، یا

URL تصویر منبع برای ارتقای وضوح.

پیش‌فرض Wonder 3

انتخاب مدل ارتقای وضوح مولد: Recovery و Recovery V2 تصاویر با وضوح بسیار پایین را بازسازی می‌کنند؛ Redefine با پرامپت جزئیات خلاقانه را هدایت می‌کند؛ Standard MAX دقت و کیفیت بالا را ترجیح می‌دهد؛ Recover 3 جزئیات طبیعی را بازسازی می‌کند. در خانواده Wonder، مدل‌های Wonder و Wonder 2 پیش از Wonder 3، پیشرفته‌ترین مدل واقع‌گرایی مولد، قرار دارند؛ جدیدترین نسخه، Wonder 3.5، جزئیات ظریف‌تر و تکرار الگوی کمتری ارائه می‌دهد.

پیش‌فرض 2

ضریب بزرگ‌نمایی تصویر؛ برای نمونه، 2.0 هر دو بُعد را دو برابر می‌کند.

پیشرفته output_format · subject_detection · enhancement_strength · face_enhancement_creativity · face_enhancement_strength · creativity · texture · sharpen · denoise · detail · crop_to_fill · face_enhancement · autoprompt · enable_safety_checker
output_format پیش‌فرض jpeg

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

subject_detection پیش‌فرض All

نحوه شناسایی سوژه‌ها هنگام بهبود تصاویر با Recovery V2، Wonder 3 یا Recovery.

enhancement_strength

قدرت بهبود ارتقای وضوح مولد که در صورت مشخص‌نشدن به‌طور خودکار تنظیم می‌شود؛ مدل‌های پشتیبانی‌شده Wonder 3.5 و Wonder 3 هستند.

پیش‌فرض 0

کنترل خلاقیت بهبود چهره، فقط هنگام فعال بودن بهبود چهره: برای بیشترین خلاقیت 1.0 و برای عدم اعمال 0.0 را تنظیم کنید.

پیش‌فرض 0.8

کنترل قدرت بهبود چهره، فقط هنگام فعال بودن بهبود چهره: برای بیشترین بهبود 1.0 و برای عدم اعمال 0.0 را تنظیم کنید.

خلاقیت ارتقای وضوح مولد از 1 تا 6، فقط پشتیبانی‌شده توسط Redefine. افزایش آن جزئیات خیال‌پردازانه یا توهمی بیشتری می‌افزاید.

کنترل جزئیات بافت، انحصاری ارتقای وضوح مولد Redefine، با سطوح 1 تا 5.

شدت وضوح‌بخشی از 0.0 تا 1.0، فقط پشتیبانی‌شده توسط Redefine.

شدت حذف نویز از 0.0 تا 1.0، فقط پشتیبانی‌شده توسط Redefine.

شدت بازیابی جزئیات از 0.0 تا 1.0، فقط پشتیبانی‌شده توسط Recovery V2.

POST /run/topaz/upscale/image/generative?wait=20 قیمت → ⁨‎$۰٫۰۸⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/topaz/upscale/image/generative?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

درباره Topaz Upscale Image Generative

تصویر را از 1x تا 4x با انتخاب `model` افزایش وضوح می‌دهد؛ از جمله Wonder 3.5، Wonder 3، Recover 3، Redefine و Recovery V2. بهبود چهره کنترل‌های جداگانه شدت و خلاقیت دارد. Redefine یک `prompt` حداکثر 1024 کاراکتری به‌همراه `creativity`، `texture`، `sharpen` و `denoise` اضافه می‌کند. برای منابع کوچک یا تار مناسب است.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
image_urlالزامی image
نوعurl · image
URL تصویر منبع برای ارتقای وضوح.
modelاختیاری
نوعenum
پیش‌فرضWonder 3
Wonder 3.5Wonder 3Wonder 2WonderRecover 3Standard MAXRedefineRecovery V2Recovery
انتخاب مدل ارتقای وضوح مولد: Recovery و Recovery V2 تصاویر با وضوح بسیار پایین را بازسازی می‌کنند؛ Redefine با پرامپت جزئیات خلاقانه را هدایت می‌کند؛ Standard MAX دقت و کیفیت بالا را ترجیح می‌دهد؛ Recover 3 جزئیات طبیعی را بازسازی می‌کند. در خانواده Wonder، مدل‌های Wonder و Wonder 2 پیش از Wonder 3، پیشرفته‌ترین مدل واقع‌گرایی مولد، قرار دارند؛ جدیدترین نسخه، Wonder 3.5، جزئیات ظریف‌تر و تکرار الگوی کمتری ارائه می‌دهد.
upscale_factorاختیاری
نوعnumber
پیش‌فرض2
۱ – ۴
ضریب بزرگ‌نمایی تصویر؛ برای نمونه، 2.0 هر دو بُعد را دو برابر می‌کند.
crop_to_fillاختیاری
نوعboolean
پیش‌فرضfalse
output_formatاختیاری
نوعenum
پیش‌فرضjpeg
jpegpng
قالب تصویر ارتقایافته.
subject_detectionاختیاری
نوعenum
پیش‌فرضAll
AllForegroundBackground
نحوه شناسایی سوژه‌ها هنگام بهبود تصاویر با Recovery V2، Wonder 3 یا Recovery.
face_enhancementاختیاری
نوعboolean
پیش‌فرضtrue
کلید فعال‌سازی بهبود چهره تصویر.
face_enhancement_creativityاختیاری
نوعnumber
پیش‌فرض0
۰ – ۱
کنترل خلاقیت بهبود چهره، فقط هنگام فعال بودن بهبود چهره: برای بیشترین خلاقیت 1.0 و برای عدم اعمال 0.0 را تنظیم کنید.
face_enhancement_strengthاختیاری
نوعnumber
پیش‌فرض0.8
۰ – ۱
کنترل قدرت بهبود چهره، فقط هنگام فعال بودن بهبود چهره: برای بیشترین بهبود 1.0 و برای عدم اعمال 0.0 را تنظیم کنید.
enhancement_strengthاختیاری
نوعenum
lowmediumhigh
قدرت بهبود ارتقای وضوح مولد که در صورت مشخص‌نشدن به‌طور خودکار تنظیم می‌شود؛ مدل‌های پشتیبانی‌شده Wonder 3.5 و Wonder 3 هستند.
creativityاختیاری
نوعinteger | null
۱ – ۶
خلاقیت ارتقای وضوح مولد از 1 تا 6، فقط پشتیبانی‌شده توسط Redefine. افزایش آن جزئیات خیال‌پردازانه یا توهمی بیشتری می‌افزاید.
textureاختیاری
نوعinteger | null
۱ – ۵
کنترل جزئیات بافت، انحصاری ارتقای وضوح مولد Redefine، با سطوح 1 تا 5.
promptاختیاری
نوعstring | null
≤ ۱٬۰۲۴ نویسه
متن راهنما برای ارتقای وضوح مولد، محدود به 1024 نویسه و فقط پشتیبانی‌شده توسط Redefine.
autopromptاختیاری
نوعboolean | null
کلید تولید خودکار پرامپت، انحصاری ارتقای وضوح مولد Redefine.
sharpenاختیاری
نوعnumber | null
۰ – ۱
شدت وضوح‌بخشی از 0.0 تا 1.0، فقط پشتیبانی‌شده توسط Redefine.
denoiseاختیاری
نوعnumber | null
۰ – ۱
شدت حذف نویز از 0.0 تا 1.0، فقط پشتیبانی‌شده توسط Redefine.
detailاختیاری
نوعnumber | null
۰ – ۱
شدت بازیابی جزئیات از 0.0 تا 1.0، فقط پشتیبانی‌شده توسط Recovery V2.
enable_safety_checkerاختیاری
نوعboolean
پیش‌فرضtrue
با تنظیم false، در صورت مجاز بودن فراخواننده، می‌توان بررسی را آسان‌گیرانه‌تر کرد.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

پارامترهای فایل یک URL عمومی https://، یک URI از نوع data: تا سقف 10 MB، یا file_url یک فایل بارگذاری‌شده را می‌پذیرند. فایل‌ها

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "topaz/upscale/image/generative",
  "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": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "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
    }
  },
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
فایل‌های شما، انتخاب شماهر outputs[].url کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
image
object {url, content_type, file_name, file_size}تصویر تولیدشده با بزرگ‌نمایی.

مدل‌های بیشتر: ارتقای وضوح

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