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
Google Nano Banana
Image generation 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": "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-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"
required
Model name, must be
google/nano-bananastring
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 generation
Hide Example
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, jpegenum<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, autoResponse
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": "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"
}
}