رفتن به محتوا

Topaz Image Upscale

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

شناسه مدل topaz/upscale/image/precision
# 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/precision?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",
    "upscale_factor": 2
  }'

# 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#restoration#faces

افزایش وضوح تصویر Topaz Labs با بازیابی چهره، کاهش نویز و وضوح‌بخشی، تا 4x.

Topaz Labs · تصویر

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

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

ساخت درخواست

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

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

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

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

پیشرفته model · output_format · subject_detection · face_enhancement_creativity · face_enhancement_strength · sharpen · denoise · fix_compression · strength · crop_to_fill · face_enhancement
model پیش‌فرض Standard V2

انتخاب مدل ارتقای وضوح دقیق: Faces برای بازسازی چهره از Face Recovery 3، Text Refine برای حفظ متن و شکل‌های واضح، و CGI برای آثار هنری و گرافیک رندرشده است. برای عکس‌ها، Standard V2 بیشتر کاربردها را پوشش می‌دهد؛ High Fidelity V3 و High Fidelity V2 جزئیات ثبت‌شده حرفه‌ای را حفظ می‌کنند و Low Resolution V2 منابع فشرده را بازسازی می‌کند.

output_format پیش‌فرض jpeg

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

subject_detection پیش‌فرض All

تنظیم شناسایی سوژه هنگام بهبود تصویر.

پیش‌فرض 0

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

پیش‌فرض 0.8

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

شدت وضوح‌بخشی از 0.0 تا 1.0، با مقدار پیش‌فرض وابسته به مدل.

شدت حذف نویز از 0.0 تا 1.0، با مقدار پیش‌فرض وابسته به مدل.

شدت حذف آثار فشرده‌سازی از 0.0 تا 1.0؛ با CGI در دسترس نیست.

شدت بهبود از 0.01 تا 1.0، فقط پشتیبانی‌شده توسط Text Refine.

POST /run/topaz/upscale/image/precision?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/precision?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",
    "upscale_factor": 2
  }'

# 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 Image Upscale

عکس یا رندر را تا چهار برابر با مدل‌های Topaz متناسب با منابع مختلف بزرگ می‌کند: عکس‌های استاندارد، وفاداری بالا، منابع کم‌وضوح، CGI، متن و چهره‌ها. بهبود اختیاری چهره، کاهش نویز، وضوح‌بخشی و ترمیم فشرده‌سازی؛ خروجی JPEG یا PNG.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
image_urlالزامی image
نوعurl · image
URL تصویر منبع برای ارتقای وضوح.
modelاختیاری
نوعenum
پیش‌فرضStandard V2
Standard V2High Fidelity V3High Fidelity V2Low Resolution V2CGIText RefineFaces
انتخاب مدل ارتقای وضوح دقیق: Faces برای بازسازی چهره از Face Recovery 3، Text Refine برای حفظ متن و شکل‌های واضح، و CGI برای آثار هنری و گرافیک رندرشده است. برای عکس‌ها، Standard V2 بیشتر کاربردها را پوشش می‌دهد؛ High Fidelity V3 و High Fidelity V2 جزئیات ثبت‌شده حرفه‌ای را حفظ می‌کنند و Low Resolution V2 منابع فشرده را بازسازی می‌کند.
upscale_factorاختیاری
نوعnumber
پیش‌فرض2
۱ – ۴
ضریب بزرگ‌نمایی تصویر؛ برای نمونه، 2.0 هر دو بُعد را دو برابر می‌کند.
crop_to_fillاختیاری
نوعboolean
پیش‌فرضfalse
output_formatاختیاری
نوعenum
پیش‌فرضjpeg
jpegpng
قالب تصویر ارتقایافته.
subject_detectionاختیاری
نوعenum
پیش‌فرضAll
AllForegroundBackground
تنظیم شناسایی سوژه هنگام بهبود تصویر.
face_enhancementاختیاری
نوعboolean
پیش‌فرضtrue
کلید فعال‌سازی بهبود چهره تصویر.
face_enhancement_creativityاختیاری
نوعnumber
پیش‌فرض0
۰ – ۱
کنترل خلاقیت بهبود چهره، فقط هنگام فعال بودن بهبود چهره: برای بیشترین خلاقیت 1.0 و برای عدم اعمال 0.0 را تنظیم کنید.
face_enhancement_strengthاختیاری
نوعnumber
پیش‌فرض0.8
۰ – ۱
کنترل قدرت بهبود چهره، فقط هنگام فعال بودن بهبود چهره: برای بیشترین بهبود 1.0 و برای عدم اعمال 0.0 را تنظیم کنید.
sharpenاختیاری
نوعnumber | null
۰ – ۱
شدت وضوح‌بخشی از 0.0 تا 1.0، با مقدار پیش‌فرض وابسته به مدل.
denoiseاختیاری
نوعnumber | null
۰ – ۱
شدت حذف نویز از 0.0 تا 1.0، با مقدار پیش‌فرض وابسته به مدل.
fix_compressionاختیاری
نوعnumber | null
۰ – ۱
شدت حذف آثار فشرده‌سازی از 0.0 تا 1.0؛ با CGI در دسترس نیست.
strengthاختیاری
نوعnumber | null
۰٫۰۱ – ۱
شدت بهبود از 0.01 تا 1.0، فقط پشتیبانی‌شده توسط Text Refine.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "topaz/upscale/image/precision",
  "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": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "upscale_factor": 2
  },
  "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/precision.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt