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": "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"
  }
}

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

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

​
Request Body

Request body format is application/json.
​
model
string
default:"google/nano-banana"
required
Model name, must be google/nano-banana
​
callback_url
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
​
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": "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"
  }
}