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
Google Nano Banana Edit
Image editing model API based on Gemini 2.5 Flash Image
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"
}
}
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-xxxxxxHide Details
Hide Details
- Get API Key: Visit the API Key Management Page to obtain your API Key
-
Usage: Add
Authorization: Bearer YOUR_API_KEYto 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 isapplication/json.
string
default:"google/nano-banana-edit"
required
Model name, must be
google/nano-banana-editstring
required
Callback URL for task completion notification. The system will POST task status and results to this URL.Example:
https://your-domain.com/api/callbackobject
required
Input parameters for the generation task
Hide Properties
Hide Properties
string
required
Text prompt for image editing
Hide Example
Hide Example
"Change the background to pixel art style"
enum<string>
default:"png"
required
Output format for generated imageAvailable options:
png, jpegenum<string>
default:"1:1"
required
Aspect ratio for generated image
string[]
required
Array of original image URLs to edit
Hide Example
Hide Example
["https://example.com/your-image.png"]
Response
integer
required
Response status code
Hide Status Codes
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
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"
}
}