رفتن به محتوا

Image2Pixel

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

شناسه مدل image2pixel
# 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/image2pixel?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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تا ⁨‎$۰٫۱۵۳⁩ برای هر اجرا بر اساس مصرف واقعی هزینه دریافت می‌شود و مابقی بازپرداخت می‌شود اجرای آن در این صفحه

دریافت کلید API
Utility ویرایش تصویر #post-processing#pixel-art

تصاویر را با محدودیت پالت، تشخیص مقیاس و پس‌زمینه شفاف اختیاری به پیکسل‌آرت تمیز تبدیل می‌کند

Utility · تصویر

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

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

ساخت درخواست

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

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

نشانی اینترنتی تصویر منبع برای تبدیل به پیکسل‌آرت بهبودیافته.

پیشرفته detect_method · downscale_method · background_mode · max_colors · scale · alpha_threshold · dominant_color_threshold · background_tolerance · auto_color_detect · trim_borders · transparent_background · cleanup_morph · cleanup_jaggy · snap_grid · fixed_palette
detect_method پیش‌فرض auto

روش مورد استفاده برای تشخیص مقیاس.

downscale_method پیش‌فرض dominant

روش مورد استفاده برای کوچک‌سازی به پیکسل‌آرت.

background_mode پیش‌فرض corners

مکان‌های شروع برای پرکردن سیلابی هنگام حذف پس‌زمینه.

پیش‌فرض 32

سقف رنگ‌های پالت خروجی؛ None تعداد نامحدودی رنگ را مجاز می‌کند.

مقیاس پیکسل برای اعمال؛ None تشخیص خودکار را فعال می‌کند.

پیش‌فرض 128

آستانه دودویی‌سازی آلفا، از 0 تا 255.

پیش‌فرض 0.05

آستانه رنگ‌های غالب، از 0.0 تا 1.0.

پیش‌فرض 0

تلورانس پس‌زمینه، از 0 تا 255.

پالت ازپیش‌تعیین‌شده اختیاری که با رشته‌های هگز مشخص می‌شود، مانند ['#000000', '#ffffff'].

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

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

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

درباره Image2Pixel

تصویر ورودی را به پیکسل‌آرت تبدیل می‌کند و تصویر پردازش‌شده به‌همراه نسخه مقیاس‌یافته را به‌صورت فایل‌های PNG برمی‌گرداند. می‌توانید پالت را با `max_colors` (از 1 تا 256) محدود کنید، `fixed_palette` از رنگ‌های hex ارائه دهید یا `scale` را از 1 تا 64 تعیین کنید. چندین روش کوچک‌سازی، گزینه پاک‌سازی و حالت حذف پس‌زمینه در دسترس است. پاسخ همچنین تعداد رنگ‌ها، پالت و مقیاس پیکسل شناسایی‌شده را گزارش می‌کند.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
image_urlالزامی image
نوعurl · image
نشانی اینترنتی تصویر منبع برای تبدیل به پیکسل‌آرت بهبودیافته.
max_colorsاختیاری
نوعinteger | null
پیش‌فرض32
۱ – ۲۵۶
سقف رنگ‌های پالت خروجی؛ None تعداد نامحدودی رنگ را مجاز می‌کند.
auto_color_detectاختیاری
نوعboolean
پیش‌فرضfalse
انتخاب خودکار تعداد بهینه رنگ‌ها را فعال می‌کند.
fixed_paletteاختیاری
نوعstring[]
پالت ازپیش‌تعیین‌شده اختیاری که با رشته‌های هگز مشخص می‌شود، مانند ['#000000', '#ffffff'].
detect_methodاختیاری
نوعenum
پیش‌فرضauto
autorunsedge
روش مورد استفاده برای تشخیص مقیاس.
scaleاختیاری
نوعinteger | null
۱ – ۶۴
مقیاس پیکسل برای اعمال؛ None تشخیص خودکار را فعال می‌کند.
downscale_methodاختیاری
نوعenum
پیش‌فرضdominant
dominantmedianmodemeancontent-adaptive
روش مورد استفاده برای کوچک‌سازی به پیکسل‌آرت.
trim_bordersاختیاری
نوعboolean
پیش‌فرضfalse
برش حاشیه‌های تصویر را کنترل می‌کند.
transparent_backgroundاختیاری
نوعboolean
پیش‌فرضfalse
حذف پس‌زمینه با شفافیت: پس از پایان اصلاح تصویر، نواحی رنگی پیوسته‌ای که به لبه تصویر می‌رسند شفاف می‌شوند.
cleanup_morphاختیاری
نوعboolean
پیش‌فرضfalse
حذف نویز با استفاده از عملیات ریخت‌شناختی.
cleanup_jaggyاختیاری
نوعboolean
پیش‌فرضfalse
پاک‌سازی لبه‌های دندانه‌دار با حذف پیکسل‌های مورب منفرد.
snap_gridاختیاری
نوعboolean
پیش‌فرضtrue
خروجی را روی شبکه پیکسل تراز می‌کند.
alpha_thresholdاختیاری
نوعinteger
پیش‌فرض128
۰ – ۲۵۵
آستانه دودویی‌سازی آلفا، از 0 تا 255.
dominant_color_thresholdاختیاری
نوعnumber
پیش‌فرض0.05
۰ – ۱
آستانه رنگ‌های غالب، از 0.0 تا 1.0.
background_toleranceاختیاری
نوعinteger
پیش‌فرض0
۰ – ۲۵۵
تلورانس پس‌زمینه، از 0 تا 255.
background_modeاختیاری
نوعenum
پیش‌فرضcorners
edgescornersmidpoints
مکان‌های شروع برای پرکردن سیلابی هنگام حذف پس‌زمینه.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "image2pixel",
  "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": 153,
    "usd": "0.153",
    "charged": 153,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "pixel_scale": 21,
    "palette": [
      "string"
    ],
    "num_colors": 10,
    "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
      }
    ]
  },
  "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"
  }
}
فایل‌های شما، انتخاب شماهر outputs[].url کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
pixel_scale
integerمقیاس پیکسل شناسایی‌شده در ورودی.
palette
array of stringپالت رنگ رسانه پردازش‌شده.
num_colors
integerتعداد رنگ‌های رسانه پردازش‌شده.
images
array of object {url, content_type, file_name, file_size, width, height}پیکسل‌آرت پردازش‌شده و تصاویر مقیاس‌یافته، هر دو با قالب PNG.

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