رفتن به محتوا

Qwen Image 3 Edit

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

شناسه مدل alibaba/qwen-image-3/edit
# 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/alibaba/qwen-image-3/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Change the sign above the door to read \"Open Daily 8-20\" in the same lettering style and color, keep everything else unchanged.",
    "images": [
      "https://content.doitong.com/dev-api/2026/10/21/req_msc9ak2dbu4cu59zvf0c2ftb/0-RBrxxuL8Z-3AAI916Qh9o_hi2fj8yl.png"
    ]
  }'

# 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 اجرای آن در این صفحه

دریافت کلید API
Alibaba ویرایش تصویر #editing#typography#multi-reference

ویرایش با یک تا سه تصویر مرجع؛ مناسب برای تغییر یا افزودن متن در تصویر.

نمونه‌ها

ورودی
خروجی · ~105 ثانیه
Change the sign above the door to read "Open Daily 8-20" in the same lettering style and color, keep everything else ...

پرامپتChange the sign above the door to read "Open Daily 8-20" in the same lettering style and color, keep everything else unchanged.

⁨‎$۰٫۰۷۵⁩ · ۷۵ اعتبار API

ساخت درخواست

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

•الزامی 127 / 5000

متن توصیف‌کننده ویرایش موردنظر، به چینی یا انگلیسی و محدود به 5000 نویسه.

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

1–3 مرجع ویرایش را در قالب JPEG، JPG، PNG (بدون آلفا) یا WEBP، با حداکثر 10MB برای هر فایل و ابعاد 384–2048px در هر محور ارائه دهید. در پرامپت بر اساس ترتیب ارائه، با 'image 1'، 'image 2' و 'image 3' به آن‌ها ارجاع دهید.

image_size

ابعاد تصویر خروجی، محدود به تعداد پیکسل کل از 512 × 512 تا 2048 × 2048. حذف اندازه، انتخاب خودکار وضوح را به مدل واگذار می‌کند.

num_images پیش‌فرض 1

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

پیشرفته negative_prompt · output_format · seed · enable_prompt_expansion
0 / 500

محتوایی که باید از تصویر نهایی حذف شود، محدود به 500 نویسه.

output_format پیش‌فرض png

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

Seed تصادفی برای نتایج تکرارپذیر، از 0 تا 2147483647.

POST /run/alibaba/qwen-image-3/edit?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/alibaba/qwen-image-3/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Change the sign above the door to read \"Open Daily 8-20\" in the same lettering style and color, keep everything else unchanged.",
    "images": [
      "https://content.doitong.com/dev-api/2026/10/21/req_msc9ak2dbu4cu59zvf0c2ftb/0-RBrxxuL8Z-3AAI916Qh9o_hi2fj8yl.png"
    ]
  }'

# 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

درباره Qwen Image 3 Edit

حالت ویرایش Qwen Image 3 یک تا سه تصویر مرجع (384 تا 2048 px در هر ضلع) و یک دستور می‌گیرد که می‌تواند به آن‌ها با image 1، image 2 و image 3 ارجاع دهد. این مدل به‌ویژه در جایگزینی یا افزودن نوشته توانمند است. اندازه را خالی بگذارید تا مدل انتخاب کند، یا اندازهٔ ازپیش‌تنظیم‌شده یا سفارشی تا 2K تعیین کنید؛ حداکثر شش نتیجه در هر درخواست.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
≤ ۵٬۰۰۰ نویسه
متن توصیف‌کننده ویرایش موردنظر، به چینی یا انگلیسی و محدود به 5000 نویسه.
negative_promptاختیاری
نوعstring | null
پیش‌فرض
≤ ۵۰۰ نویسه
محتوایی که باید از تصویر نهایی حذف شود، محدود به 500 نویسه.
image_sizeاختیاری
نوعobject
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
ابعاد تصویر خروجی، محدود به تعداد پیکسل کل از 512 × 512 تا 2048 × 2048. حذف اندازه، انتخاب خودکار وضوح را به مدل واگذار می‌کند.
enable_prompt_expansionاختیاری
نوعboolean
پیش‌فرضtrue
بازنویسی خودکار پرامپت توسط LLM برای بهبود نتایج را کنترل می‌کند.
seedاختیاری
نوعinteger | null
Seed تصادفی برای نتایج تکرارپذیر، از 0 تا 2147483647.
num_imagesاختیاری num_outputs
نوعinteger
پیش‌فرض1
۱ – ۶
تعداد تصاویر درخواستی برای تولید.
output_formatاختیاری
نوعenum
پیش‌فرضpng
jpegpngwebp
قالب فایل تصویر نهایی.
image_urlsالزامی images
نوعurl[] · image
1–3 مرجع ویرایش را در قالب JPEG، JPG، PNG (بدون آلفا) یا WEBP، با حداکثر 10MB برای هر فایل و ابعاد 384–2048px در هر محور ارائه دهید. در پرامپت بر اساس ترتیب ارائه، با 'image 1'، 'image 2' و 'image 3' به آن‌ها ارجاع دهید.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "alibaba/qwen-image-3/edit",
  "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": 75,
    "usd": "0.075",
    "charged": 75,
    "refunded": 0
  },
  "input": {
    "prompt": "Change the text on the sneaker's side to read \"RUN\" in bold letters",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_sneaker_ad.jpg"
    ]
  },
  "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
      }
    ],
    "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.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 شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
images
array of object {url, content_type, file_name, file_size}تصاویر تولیدشده.
seed
integerمقدار Seed اعمال‌شده هنگام تولید.

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

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