رفتن به محتوا

CodeFormer

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

شناسه مدل codeformer
# 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/codeformer?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
Open model ویرایش تصویر #image-restoration#faces#utility

مدل بازسازی چهره که پرتره‌های تار یا مخدوش را ترمیم می‌کند و ترازکردن و ارتقای وضوح اختیاری دارد

Open model · تصویر

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

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

ساخت درخواست

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

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

URL تصویری که نورپردازی مجدد روی آن انجام می‌شود.

پیش‌فرض 2

ضریب اعمال‌شده هنگام ارتقای وضوح.

پیشرفته fidelity · seed · aligned · only_center_face · face_upscale
پیش‌فرض 0.5

وزن اختصاص‌یافته به عامل وفاداری.

seed تصادفی که تولید تکرارپذیر را ممکن می‌کند.

POST /run/codeformer?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/codeformer?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

درباره CodeFormer

چهره‌های افراد را در عکس آسیب‌دیده یا تارِ ارائه‌شده در `image_url` بازسازی می‌کند. `fidelity` بین بازسازی و ظاهر اصلی تعادل ایجاد می‌کند (پیش‌فرض 0.5) و `upscale_factor` خروجی را بزرگ می‌کند (پیش‌فرض 2). گزینه‌های `only_center_face`، `aligned` و `face_upscale` قابل تغییرند و `seed` نتایج تکرارپذیر ایجاد می‌کند.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
image_urlالزامی image
نوعurl · image
URL تصویری که نورپردازی مجدد روی آن انجام می‌شود.
fidelityاختیاری
نوعnumber
پیش‌فرض0.5
وزن اختصاص‌یافته به عامل وفاداری.
upscale_factorاختیاری
نوعnumber
پیش‌فرض2
≥ ۱
ضریب اعمال‌شده هنگام ارتقای وضوح.
alignedاختیاری
نوعboolean
پیش‌فرضfalse
مشخص می‌کند چهره‌ها و ویژگی‌های مشابه هم‌تراز شوند یا نه.
only_center_faceاختیاری
نوعboolean
پیش‌فرضfalse
مشخص می‌کند بازسازی فقط به چهره مرکزی محدود شود یا نه.
face_upscaleاختیاری
نوعboolean
پیش‌فرضtrue
مشخص می‌کند ارتقای وضوح روی چهره‌ها اعمال شود یا نه.
seedاختیاری
نوعinteger | null
seed تصادفی که تولید تکرارپذیر را ممکن می‌کند.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "codeformer",
  "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": 9,
    "usd": "0.009",
    "charged": 9,
    "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,
      "width": 1024,
      "height": 768
    },
    "seed": 42
  },
  "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, width, height}اطلاعات فایل تصویر تولیدشده.
seed
integerSeed تولید تصویر، شامل مقدار تصادفی انتخاب‌شده در صورت حذف Seed از ورودی؛ در غیر این صورت، مقدار ارائه‌شده را تکرار می‌کند.

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