ویرایش عکس

آدرس‌های image_urls باید عمومی و قابل دسترسی باشند. لینک‌های لاگین‌دار، فایروال یا موقت منقضی‌شده شکست می‌خورند.

درخواست

• prompt (required, string): دستور ویرایش.
  • examples: این عکس را به سبک آبرنگ تبدیل کن
• image_urls (required, string[]): آدرس عمومی عکس‌های ورودی.
  • examples: https://example.com/source.jpg
• model (optional, string): مدل مورد نظر برای تولید عکس.
  • examples: nano-banana-2, nano-banana-2-1, nano-lite, nano-pro, grok-speed, grok-quality, gpt-image-2-5-flare, gpt-image-2-5-sunburst, seedream-5-pro, flux-3-image
• image_size (optional, string): نسبت عکس خروجی.
  • examples: 16:9, 1:1, 9:16
• resolution (optional, string): کیفیت خروجی. بسته به مدل، گزینه‌های مختلفی در دسترس است.
  • examples: 1K, 2K, 4K
• num_images (optional, integer): تعداد عکس‌های خروجی. فقط برای مدل‌هایی که از چند خروجی پشتیبانی می‌کنند.
  • examples: 1, 2, 4

نمونه curl

curl -X POST "https://api.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"}'

پاسخ

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

شناسه task در فیلد id است (نه taskId). همان مقدار را در GET /api/v1/tasks/:id بگذارید و هر ۳ تا ۵ ثانیه وضعیت را پیگیری کنید.