Google Nano Banana

curl --request POST \
  --url https://api.ruxa.ai/api/v1/tasks/create \
  --header 'Authorization: Bearer sk-xxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "callback_url": "https://your-domain.com/api/callback",
    "input": {
      "prompt": "A hyper-realistic tweet posted by Einstein right after completing the theory of relativity.",
      "output_format": "png",
      "aspect_ratio": "16:9",
      "image_input": ["https://file.aiquickdraw.com/custom-page/akr/section-images/1756223420389w8xa2jfe.png"]
    },
    "model": "google/nano-banana"
  }'

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_gemini-2.5-flash-image_1766304530229_cf4dafd2"
  }
}

POST

api

tasks

create

curl --request POST \
  --url https://api.ruxa.ai/api/v1/tasks/create \
  --header 'Authorization: Bearer sk-xxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "callback_url": "https://your-domain.com/api/callback",
    "input": {
      "prompt": "A hyper-realistic tweet posted by Einstein right after completing the theory of relativity.",
      "output_format": "png",
      "aspect_ratio": "16:9",
      "image_input": ["https://file.aiquickdraw.com/custom-page/akr/section-images/1756223420389w8xa2jfe.png"]
    },
    "model": "google/nano-banana"
  }'

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_gemini-2.5-flash-image_1766304530229_cf4dafd2"
  }
}

google/nano-banana uses Google’s gemini-2.5-flash-image model internally.

Query Task Status

After submitting a task, you can check the task progress and get the generation result through the unified query endpoint:

Get Task Details

Learn how to query task status and get generation results

In production environments, it is recommended to use the callback_url parameter to receive automatic notifications when generation is complete, rather than polling the status endpoint.

Authorization

string

required

Bearer Token authentication. Format: Bearer sk-xxxxxx

Hide Details

Get API Key: Visit the API Key Management Page to obtain your API Key
Usage: Add Authorization: Bearer YOUR_API_KEY to your request headers
Important: Keep your API Key secure and never share it with others
If you suspect your API Key has been compromised, reset it immediately in the management page

Request Body

Request body format is application/json.

string

default:"google/nano-banana"

required

Model name, must be google/nano-banana

string

Callback URL for task completion notification. The system will POST task status and results to this URL.Example: https://your-domain.com/api/callback

object

required

Input parameters for the generation task

Hide Properties

string

required

Text prompt for image generation

Hide Example

"A hyper-realistic tweet posted by Einstein right after completing the theory of relativity."

enum<string>

default:"png"

Output format for generated imageAvailable options: png, jpeg

enum<string>

default:"1:1"

Aspect ratio for generated imageAvailable options: 1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9, auto

Response

integer

required

Response status code

Hide Status Codes

200: Success - Request processed successfully
401: Unauthorized - Missing or invalid authentication
402: Insufficient credits - Not enough credits to execute
404: Not found - Resource or endpoint does not exist
422: Validation error - Request parameters invalid
429: Rate limited - Request frequency limit exceeded
500: Server error - Unexpected failure during processing

string

required

Response message, error description when request fails

object

required

Hide Properties

string

required

Task ID for querying task status

curl --request POST \
  --url https://api.ruxa.ai/api/v1/tasks/create \
  --header 'Authorization: Bearer sk-xxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "callback_url": "https://your-domain.com/api/callback",
    "input": {
      "prompt": "A hyper-realistic tweet posted by Einstein right after completing the theory of relativity.",
      "output_format": "png",
      "aspect_ratio": "16:9",
      "image_input": ["https://file.aiquickdraw.com/custom-page/akr/section-images/1756223420389w8xa2jfe.png"]
    },
    "model": "google/nano-banana"
  }'

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_gemini-2.5-flash-image_1766304530229_cf4dafd2"
  }
}

Getting Started

Image Series

Video Series

Common

Query Task Status

Get Task Details

Authorization

Request Body

Response

​Query Task Status

Get Task Details

​Authorization

​Request Body

​Response

Query Task Status

Authorization

Request Body

Response