Text to Image

تولید عکس

با ارسال یک پرامپت متنی، یک یا چند عکس جدید تولید کنید.

مسیر درخواست

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

درخواست

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

promptالزامیstring

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

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

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

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": "9:16",
    "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}

یادداشت

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