تصویر

ویرایش تصویر

یک تا چهار تصویر مرجع، و اگر لازم است یک ماسک، همراه توضیح متنی بفرستید و تصویر ویرایش‌شده بگیرید. درخواست از نوع multipart است.

POST/v1/images/edits

این مسیر درخواست multipart/form-data می‌گیرد، نه JSON. تصویرها را در فیلد image یا image[] بفرستید (تا ۴ فایل، هر کدام تا ۲۵ مگابایت). فیلد mask اختیاری و حداکثر یک فایل است. نوع هر فایل از روی خود بایت‌ها تشخیص داده می‌شود و فقط PNG، JPEG، WebP و GIF پذیرفته است؛ فایل دیگری invalid_image می‌گیرد.

فقط مدلی که ویرایش یا ورودی تصویر را پشتیبانی می‌کند قبول می‌شود، وگرنه خطای model_cannot_edit می‌گیرید. هزینه علاوه بر قیمت هر تصویر خروجی، به ازای هر تصویر مرجع هم حساب می‌شود (قیمت image_input). قیمت‌ها در مدل‌ها هستند.

قاعده‌های quality همان ساخت تصویر است: بدون آن، برای مدل با قیمت جدا هر کیفیت، medium به کار می‌رود. شکل پاسخ هم همان است.

نمونه‌ها

curl https://1ai.ir/v1/images/edits \
  -H "Authorization: Bearer $ONEAI_API_KEY" \
  -F 'model=openai/gpt-image-2' \
  -F 'prompt=Replace the background with a snowy mountain' \
  -F 'size=1024x1024' \
  -F "image=@portrait.png"
200پاسخ
{
  "created": 1788864000,
  "model": "openai/gpt-image-2",
  "data": [
    {
      "url": "https://example.com/files/img_example.png"
    }
  ]
}

بدنه‌ی درخواست

  • modelstringالزامی

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

  • promptstringالزامی

    توضیح تغییر مورد نظر، تا ۳۲٬۰۰۰ نویسه.

  • imagefileالزامی

    تصویر مرجع (PNG، JPEG، WebP یا GIF). برای چند تصویر، تا ۴ فایل را زیر image یا image[] بفرستید. هر فایل تا ۲۵ مگابایت است.

  • maskfile

    ماسک اختیاری، یک فایل تصویر (PNG، JPEG، WebP یا GIF).

  • ninteger

    تعداد تصویر خروجی، از ۱ تا ۱۰.

  • sizestring

    اندازه‌ی خروجی، مثل 1024x1024.

  • qualitystring

    کیفیت خروجی. xhigh و max فقط برای مدلی که قیمت جدا برای آن‌ها دارد.

  • response_formatstring

    شکل برگشت تصویر.

    مقادیر مجاز:urlb64_json
  • backgroundstring

    گزینه‌ی پس‌زمینه، برای مدل‌هایی که آن را می‌شناسند.

  • input_fidelitystring

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

  • output_formatstring

    قالب فایل خروجی، تا ۱۰ نویسه.

  • output_compressioninteger

    فشرده‌سازی خروجی، از ۰ تا ۱۰۰.

خطاها

  • invalid_request400

    فیلد لازم نیست؛ مثلاً هیچ image ارسال نشده یا prompt خالی است.

  • too_many_images400

    بیش از ۴ تصویر فرستاده شده است (param: image).

  • invalid_image400

    فایل image یا mask PNG، JPEG، WebP یا GIF نیست.

  • model_cannot_edit400

    این مدل تصویر را ویرایش نمی‌کند (param: model).

  • invalid_quality400

    کیفیت xhigh یا max برای این مدل قیمت جدا ندارد.

  • insufficient_credits402

    اعتبار برای این درخواست کافی نیست.

  • model_not_found404

    مدل وجود ندارد یا به آن دسترسی ندارید.

صفحه‌های مرتبط