رفتن به محتوا

Phota

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

شناسه مدل phota/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/phota/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "images": [
      "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 اجرای آن در این صفحه

دریافت کلید API
Open model ویرایش تصویر خروجی 4Kحداکثر 4K #edit#personalization#typography#phota

ویرایش عکس با حفظ هویت از 1 تا 10 تصویر ورودی، با امکان استفاده از پروفایل‌های آموزش‌دیده

Open model · تصویر

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

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

ساخت درخواست

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

•الزامی 88 / 8000

پرامپت تولید تصویر که می‌تواند شامل ارجاع‌هایی مانند [[profile_id_1]] و [[profile_id_2]] در کنار توضیح آنچه باید ایجاد شود باشد.

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

تصاویر قابل ویرایش، ارائه‌شده به‌صورت URL یا URI داده Base64؛ موارد پس از 10 مورد اول نادیده گرفته می‌شوند. حداقل یک تصویر ارائه کنید یا برای تولید فقط از متن، از نقطه پایانی `/` استفاده کنید.

resolution پیش‌فرض 1K

وضوح مورد استفاده برای تصویر تولیدشده.

aspect_ratio پیش‌فرض auto

نسبت عرض به ارتفاع تصویر خروجی.

num_images پیش‌فرض 1

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

پیشرفته output_format · base_model · enable_safety_checker · profile_ids
output_format پیش‌فرض jpeg

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

base_model پیش‌فرض nb2

انتخاب مدل رندر؛ `4K` فقط از طریق `nb2` در دسترس است. لایه‌های هویتی روی هر مدل پایه انتخاب‌شده قرار می‌گیرند و همه انتخاب‌ها با پروفایل‌های آموزش‌دیده سازگارند.

انتخاب پروفایل برای تولید تصویر، به‌صورت فهرستی از IDها؛ پرامپت می‌تواند این پروفایل‌ها را با @Profile1، @Profile2 و مانند آن‌ها علامت‌گذاری کند.

POST /run/phota/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/phota/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "images": [
      "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

درباره Phota

عکس‌های موجود را با `prompt` حداکثر 8000 نویسه‌ای و `image_urls` ویرایش می‌کند؛ حداقل یک تصویر لازم است و بیش از 10 تصویر استفاده نمی‌شود. برای قابل‌شناسایی ماندن افراد خاص، `profile_ids` را ارسال کنید. `base_model` می‌تواند nb2، qwen-image-2، flux-2 یا seedream-5-pro باشد و خروجی 4K فقط با nb2 کار می‌کند. 1 تا 4 تصویر در قالب JPEG یا PNG برمی‌گرداند.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
≤ ۸٬۰۰۰ نویسه
پرامپت تولید تصویر که می‌تواند شامل ارجاع‌هایی مانند [[profile_id_1]] و [[profile_id_2]] در کنار توضیح آنچه باید ایجاد شود باشد.
num_imagesاختیاری num_outputs
نوعinteger
پیش‌فرض1
۱ – ۴
تعداد تصاویری که باید تولید شوند.
profile_idsاختیاری
نوعstring[]
انتخاب پروفایل برای تولید تصویر، به‌صورت فهرستی از IDها؛ پرامپت می‌تواند این پروفایل‌ها را با @Profile1، @Profile2 و مانند آن‌ها علامت‌گذاری کند.
output_formatاختیاری
نوعenum
پیش‌فرضjpeg
jpegpng
قالب فایل تصویر نهایی.
resolutionاختیاری
نوعenum
پیش‌فرض1K
1K4K
وضوح مورد استفاده برای تصویر تولیدشده.
aspect_ratioاختیاری
نوعenum
پیش‌فرضauto
auto1:116:94:33:49:16
نسبت عرض به ارتفاع تصویر خروجی.
base_modelاختیاری
نوعenum
پیش‌فرضnb2
nb2qwen-image-2flux-2seedream-5-pro
انتخاب مدل رندر؛ `4K` فقط از طریق `nb2` در دسترس است. لایه‌های هویتی روی هر مدل پایه انتخاب‌شده قرار می‌گیرند و همه انتخاب‌ها با پروفایل‌های آموزش‌دیده سازگارند.
image_urlsالزامی images
نوعurl[] · image
تصاویر قابل ویرایش، ارائه‌شده به‌صورت URL یا URI داده Base64؛ موارد پس از 10 مورد اول نادیده گرفته می‌شوند. حداقل یک تصویر ارائه کنید یا برای تولید فقط از متن، از نقطه پایانی `/` استفاده کنید.
enable_safety_checkerاختیاری
نوعboolean
پیش‌فرضtrue
با تنظیم false، در صورت مجاز بودن فراخواننده، می‌توان بررسی را آسان‌گیرانه‌تر کرد.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "phota/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": 90,
    "usd": "0.09",
    "charged": 90,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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
      }
    ]
  },
  "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, width, height}URL اشاره‌کننده به تصویر ویرایش‌شده.

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

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