رفتن به محتوا

Uso

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

شناسه مدل uso
# 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/uso?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_urls": [
      "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
ByteDance ویرایش تصویر #image-to-image

تولید تصویر مبتنی بر سبک و موضوع از یک تصویر محتوا به‌همراه یک یا دو تصویر سبک

ByteDance · تصویر

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

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

ساخت درخواست

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

پیش‌فرض

متن پرامپت تولید؛ برای اجرای صرفاً انتقال سبک، خالی بگذارید.

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

فهرست URL تصاویر با این ترتیب: [content_image, style_image, extra_style_image].

image_size پیش‌فرض square_hd

ابعاد تصویر تولیدشده.

num_images پیش‌فرض 1

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

پیشرفته negative_prompt · output_format · num_inference_steps · guidance_scale · seed · keep_size · enable_safety_checker
پیش‌فرض

محتوای ناخواسته تصویر برای حذف، شامل عناصر، سبک‌ها و مصنوعات.

output_format پیش‌فرض png

قالب تصویر خروجی: PNG شفافیت را حفظ می‌کند، درحالی‌که JPEG فایل‌های کوچک‌تری تولید می‌کند.

پیش‌فرض 28

تعداد تکرارهای حذف نویز؛ با افزایش آن، زمان تولید بیشتر و احتمالاً کیفیت بهتر می‌شود.

پیش‌فرض 4

کنترل پایبندی به پرامپت؛ این مقدار را افزایش دهید تا نتیجه بیشتر از پرامپت پیروی کند.

Seed کنترل‌کننده تصادفی‌بودن تولید. استفاده دوباره از seed نتایج سازگار و بازتولیدپذیر ایجاد می‌کند.

POST /run/uso?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/uso?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_image_urls": [
      "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

درباره Uso

`input_image_urls` را به‌ترتیب تصویر محتوا، تصویر سبک و تصویر سبک اضافی اختیاری دریافت می‌کند. برای انتقال خالص سبک، پرامپت می‌تواند خالی باشد و `negative_prompt` عناصر ناخواسته را حذف می‌کند. `keep_size` چیدمان و ابعاد تصویر محتوا را حفظ می‌کند. در هر اجرا 1 تا 4 تصویر با 1 تا 50 گام و خروجی PNG یا JPEG تولید می‌کند.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
promptاختیاری
نوعstring
پیش‌فرض
متن پرامپت تولید؛ برای اجرای صرفاً انتقال سبک، خالی بگذارید.
input_image_urlsالزامی
نوعurl[] · image
فهرست URL تصاویر با این ترتیب: [content_image, style_image, extra_style_image].
image_sizeاختیاری
نوعobject
پیش‌فرضsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
ابعاد تصویر تولیدشده.
negative_promptاختیاری
نوعstring
پیش‌فرض
محتوای ناخواسته تصویر برای حذف، شامل عناصر، سبک‌ها و مصنوعات.
num_inference_stepsاختیاری
نوعinteger
پیش‌فرض28
۱ – ۵۰
تعداد تکرارهای حذف نویز؛ با افزایش آن، زمان تولید بیشتر و احتمالاً کیفیت بهتر می‌شود.
guidance_scaleاختیاری
نوعnumber
پیش‌فرض4
۱ – ۱۰
کنترل پایبندی به پرامپت؛ این مقدار را افزایش دهید تا نتیجه بیشتر از پرامپت پیروی کند.
keep_sizeاختیاری
نوعboolean
پیش‌فرضfalse
هنگام پردازش، اندازه و چیدمان تصویر محتوا را حفظ می‌کند؛ گزینه‌ای مناسب برای انتقال سبک.
num_imagesاختیاری num_outputs
نوعinteger
پیش‌فرض1
۱ – ۴
تعداد تصاویر تولیدشده به‌صورت هم‌زمان.
seedاختیاری
نوعinteger | null
Seed کنترل‌کننده تصادفی‌بودن تولید. استفاده دوباره از seed نتایج سازگار و بازتولیدپذیر ایجاد می‌کند.
enable_safety_checkerاختیاری
نوعboolean
پیش‌فرضtrue
تشخیص و فیلتر محتوای NSFW را فعال می‌کند.
output_formatاختیاری
نوعenum
پیش‌فرضpng
jpegpng
قالب تصویر خروجی: PNG شفافیت را حفظ می‌کند، درحالی‌که JPEG فایل‌های کوچک‌تری تولید می‌کند.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "uso",
  "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": 100,
    "usd": "0.10",
    "charged": 100,
    "refunded": 0
  },
  "input": {
    "input_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.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,
        "width": 1024,
        "height": 768
      }
    ],
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string",
    "timings": {}
  },
  "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 شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
images
array of object {url, content_type, file_name, file_size, width, height}تصاویر تولیدشده با شخصی‌سازی سبک، شخصی‌سازی سوژه یا هر دو.
seed
integerمقدار بذر استفاده‌شده هنگام تولید.
has_nsfw_concepts
array of booleanنتایج تشخیص NSFW برای هر تصویر تولیدشده.
prompt
stringپرامپت استفاده‌شده هنگام تولید.
timings
objectاندازه‌گیری‌های زمان اجرا، تفکیک‌شده بر اساس مرحله.

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