Text to Image

تولید تصویر

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

Endpoint

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

درخواست

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

promptالزامیstring

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

مثال:شهری آینده‌نگر در غروب

modelاختیاریstring

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

مثال:nano-banana-2

image_sizeاختیاریstring

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

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

resolutionاختیاریstring

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

مثال:1K2K4K

num_imagesاختیاریinteger

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

مثال:124

bash

curl -X POST "https://bananaai.ir/api/v1/images/generations" \
  -H "Authorization: Bearer ba_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "شهری آینده‌نگر در غروب",
    "image_size": "16:9",
    "resolution": "2K"
  }'

پاسخ

json

1{
2  "id": "task_abc123",
3  "status": "pending",
4  "model": "nano-banana-2",
5  "credits_reserved": 8,
6  "created_at": "2026-07-04T12:00:00.000Z"
7}

یادداشت

بعد از دریافت taskId، مسیر وضعیت task را بررسی کنید تا نتیجه آماده شود.