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": "Turn this photo into a bobblehead: slightly enlarge the head, keep the face accurate, cartoonize the body. [Place it on a bookshelf].",
      "image_input": ["https://example.com/your-image.png"],
      "aspect_ratio": "1:1",
      "resolution": "1k",
      "output_format": "png"
    },
    "model": "google/nano-banana-pro"
  }'

{
  "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-pro uses Google’s gemini-2.5-flash-image model internally, supporting higher resolution image generation with more precise aspect ratio and resolution control.

​
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-pro"
required
Model name, must be google/nano-banana-pro
​
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": "Turn this photo into a bobblehead: slightly enlarge the head, keep the face accurate, cartoonize the body. [Place it on a bookshelf].",
      "image_input": ["https://example.com/your-image.png"],
      "aspect_ratio": "1:1",
      "resolution": "1k",
      "output_format": "png"
    },
    "model": "google/nano-banana-pro"
  }'

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