Skip to main content
POST
/
api
/
v1
/
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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.ruxa.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Authorization
string
required
Bearer Token authentication. Format: Bearer sk-xxxxxx

​
Request Body

Request body format is application/json.
​
model
string
default:"google/nano-banana-edit"
required
Model name, must be google/nano-banana-edit
​
callback_url
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
​
input
object
required
Input parameters for the generation task

​
Response

​
code
integer
required
Response status code
​
message
string
required
Response message, error description when request fails
​
data
object
required
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"
  }
}