تصویر به تصویر

ویرایش تصویر

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

مسیر درخواست

POSThttps://bananaai.ir/api/v1/images/edits

درخواست

بدنه درخواست باید JSON باشد و این فیلدها را می‌پذیرد:

promptالزامیstring

توضیح تغییری که می‌خواهید روی تصویر انجام شود.

مثال:این تصویر را به سبک آبرنگ تبدیل کن

image_urlsالزامیstring[]

آرایه‌ای از URL تصویرهای مرجع. هر URL باید برای سرویس ما قابل دسترسی باشد.

مثال:https://example.com/source.jpg

modelاختیاریstring

مدل مورد نظر برای تولید تصویر.

مثال:nano-banana-2

image_sizeاختیاریstring

نسبت تصویر خروجی.

مثال:16:91:19:16

resolutionاختیاریstring

کیفیت خروجی. بسته به مدل، گزینه‌های مختلفی در دسترس است.

مثال:1K2K4K

num_imagesاختیاریinteger

تعداد تصویرهای خروجی. فقط برای مدل‌هایی که از چند خروجی پشتیبانی می‌کنند.

مثال:124

اطلاعات

URL تصویرها باید برای سرویس ما قابل دسترسی باشند. اگر تصویر پشت لاگین، فایروال یا لینک موقت منقضی‌شده باشد، درخواست ناموفق می‌شود.

bash

curl -X POST "https://bananaai.ir/api/v1/images/edits" \
  -H "Authorization: Bearer ba_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "این تصویر را به سبک آبرنگ تبدیل کن",
    "image_urls": ["https://example.com/source.jpg"],
    "image_size": "1:1",
    "resolution": "2K"
  }'

پاسخ

json

{
  "id": "task_xyz789",
  "status": "pending",
  "model": "nano-banana-2",
  "credits_reserved": 8,
  "created_at": "2026-07-04T12:00:00.000Z"
}