Google Nano Banana Edit

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": "Change the background to pixel art style",
      "output_format": "png",
      "image_size": "1:1",
      "image_urls": ["https://example.com/your-image.png"]
    },
    "model": "google/nano-banana-edit"
  }'

{
  "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": "Change the background to pixel art style",
      "output_format": "png",
      "image_size": "1:1",
      "image_urls": ["https://example.com/your-image.png"]
    },
    "model": "google/nano-banana-edit"
  }'

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

google/nano-banana-edit uses Google’s gemini-2.5-flash-image model internally, supporting image editing and modification through natural language descriptions.

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-edit"

required

Model name, must be google/nano-banana-edit

string

required

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 editing

Hide Example

"Change the background to pixel art style"

enum<string>

default:"png"

required

Output format for generated imageAvailable options: png, jpeg

enum<string>

default:"1:1"

required

Aspect ratio for generated image

string[]

required

Array of original image URLs to edit

Hide Example

["https://example.com/your-image.png"]

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": "Change the background to pixel art style",
      "output_format": "png",
      "image_size": "1:1",
      "image_urls": ["https://example.com/your-image.png"]
    },
    "model": "google/nano-banana-edit"
  }'

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

Getting Started

Image Series

Video Series

Common

Google Nano Banana Edit

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