رفتن به محتوا

Luma Photon Reframe

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

شناسه مدل luma-photon/reframe
# 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/luma-photon/reframe?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",
    "aspect_ratio": "1:1"
  }'

# 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
Luma AI ویرایش تصویر #outpainting#reframe

برون‌نقاشی استاندارد Photon که تصویر را به نسبت تصویر جدید گسترش می‌دهد و کنترل‌های ناحیه‌ای اختیاری دارد

Luma AI · تصویر

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

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

ساخت درخواست

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

0 / 5000

دستور متنی اختیاری برای هدایت قاب‌بندی مجدد.

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

URL اشاره‌کننده به تصویری که باید قاب‌بندی مجدد شود.

aspect_ratio •الزامی

نسبت ابعاد تصویر پس از قاب‌بندی مجدد.

پیشرفته grid_position_x · grid_position_y · x_end · x_start · y_end · y_start · enable_safety_checker

موقعیت افقی (X) شبکه قاب‌بندی مجدد.

موقعیت عمودی (Y) شبکه قاب‌بندی مجدد.

مختصات پایانی در راستای محور X برای قاب‌بندی مجدد.

مختصات آغازین در راستای محور X برای قاب‌بندی مجدد.

مختصات پایانی در راستای محور Y برای قاب‌بندی مجدد.

مختصات آغازین در راستای محور Y برای قاب‌بندی مجدد.

POST /run/luma-photon/reframe?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/luma-photon/reframe?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",
    "aspect_ratio": "1:1"
  }'

# 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

درباره Luma Photon Reframe

تصویر موجود در `image_url` را به یکی از نسبت‌های الزامی `aspect_ratio` شامل 1:1، 16:9، 9:16، 4:3، 3:4، 21:9 و 9:21 گسترش داده و بازقاب‌بندی می‌کند. یک `prompt` اختیاری محتوای جدید را هدایت می‌کند. موقعیت شبکه و مختصات شروع/پایان x و y امکان جای‌گذاری تصویر اصلی در قاب جدید را می‌دهند. این گونهٔ بازقاب‌بندی غیر Flash است.

پارامترها

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

نامنوع پیش‌فرضمجاز توضیحات
image_urlالزامی image
نوعurl · image
URL اشاره‌کننده به تصویری که باید قاب‌بندی مجدد شود.
aspect_ratioالزامی
نوعenum
1:116:99:164:33:421:99:21
نسبت ابعاد تصویر پس از قاب‌بندی مجدد.
promptاختیاری
نوعstring | null
≤ ۵٬۰۰۰ نویسه≥ ۳ نویسه
دستور متنی اختیاری برای هدایت قاب‌بندی مجدد.
grid_position_xاختیاری
نوعinteger | null
موقعیت افقی (X) شبکه قاب‌بندی مجدد.
grid_position_yاختیاری
نوعinteger | null
موقعیت عمودی (Y) شبکه قاب‌بندی مجدد.
x_endاختیاری
نوعinteger | null
مختصات پایانی در راستای محور X برای قاب‌بندی مجدد.
x_startاختیاری
نوعinteger | null
مختصات آغازین در راستای محور X برای قاب‌بندی مجدد.
y_endاختیاری
نوعinteger | null
مختصات پایانی در راستای محور Y برای قاب‌بندی مجدد.
y_startاختیاری
نوعinteger | null
مختصات آغازین در راستای محور Y برای قاب‌بندی مجدد.
enable_safety_checkerاختیاری
نوعboolean
پیش‌فرضtrue
با تنظیم false، در صورت مجاز بودن فراخواننده، می‌توان بررسی را آسان‌گیرانه‌تر کرد.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

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

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "luma-photon/reframe",
  "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": 19,
    "usd": "0.019",
    "charged": 19,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "aspect_ratio": "1:1"
  },
  "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
      }
    ]
  },
  "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}تصویر تولیدشده.

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

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