POST
/
nano-banana
/
generate
Generate Image
curl --request POST \
  --url https://api.unifically.com/nano-banana/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "aspect_ratio": "<string>",
  "image_urls": {}
}
'
{
  "code": 200,
  "data": {
    "status": "pending",
    "task_id": "d4e5f6g7-h8i9-0123-defg-hi4567890123"
  }
}
Generate high-quality images using the Nano Banana model powered by Gemini 2.5 Flash.

​
Pricing

For current pricing, see the Pricing page.

​
Request

curl --request POST \
  --url https://api.unifically.com/nano-banana/generate \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "A futuristic city skyline at sunset with flying cars",
    "aspect_ratio": "1:1",
    "image_urls": ["https://example.com/reference.jpg"]
  }'

​
Parameters

​
prompt
string
required
Text description of the image to generate
​
aspect_ratio
string
required
Image aspect ratio. Available options:
  • 1:1 - Square
  • 2:3 - Portrait
  • 3:2 - Landscape
  • 3:4 - Portrait
  • 4:3 - Landscape
  • 4:5 - Portrait
  • 5:4 - Landscape
  • 9:16 - Portrait (Vertical)
  • 16:9 - Landscape (Horizontal)
  • 21:9 - Ultra-wide
​
image_urls
array of strings
Array of reference image URLs to guide generation. Provide publicly accessible image URLs.Example: ["https://example.com/reference.jpg"]

​
Response

​
Successful Response

{
  "code": 200,
  "data": {
    "status": "pending",
    "task_id": "d4e5f6g7-h8i9-0123-defg-hi4567890123"
  }
}

​
Response Fields

​
code
integer
default:"200"
HTTP status code (200 for success)
​
data
object
Response data
​
status
string
Current task status: pending, processing, completed, failed
​
task_id
string
Unique identifier for this generation task
{
  "code": 200,
  "data": {
    "task_id": "4a2c4457-4e0d-4605-8615-6a6f9dbdb322",
    "status": "pending",
    "output": {},
    "error": {}
  }
}
Use the task_id to check the status using the Get Task endpoint.