# ویرایش عکس (عکس به عکس)

`POST https://api.bananaai.ir/api/v1/images/edits`


> آدرس‌های `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

```bash
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"}'
```

## پاسخ

```json
{
  "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` بگذارید و هر ۳ تا ۵ ثانیه وضعیت را پیگیری کنید.