عکس به عکس

ویرایش عکس

یک یا چند عکس مرجع را همراه با پرامپت ارسال کنید و نسخه‌ای جدید از آن‌ها بسازید.

مسیر درخواست

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

درخواست

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

promptالزامیstring

توضیح متنی تغییر موردنظر در عکس.

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

image_urlsالزامیstring[]

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

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

modelاختیاریstring

مدل مورد نظر برای تولید عکس.

مثال:nano-banana-2nano-litenano-progrok-speedgrok-qualitygpt-image-2seedream-5-pro

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"
}

یادداشت

شناسه تسک در فیلد id قرار دارد، نه taskId. برای بررسی وضعیت، همین مقدار را در GET /api/v1/tasks/:id قرار دهید و هر ۳ تا ۵ ثانیه یک‌بار درخواست بفرستید.