Getting Started with Ruxa AI API

What is Ruxa AI?

Ruxa AI provides a unified API platform for accessing AI generation models. Through a single API endpoint, you can generate videos with Sora 2 and images with Nano Banana (powered by Gemini 2.5 Flash Image).

API Endpoint

All generation tasks use the same endpoint:

POST https://api.ruxa.ai/api/v1/tasks/create

Authentication

Add your API key to the request header:

Authorization: Bearer sk-xxxxxx

Get your API key from the Dashboard.

Quick Start: Generate an Image

Here's how to generate an image using Nano Banana:

curl --request POST \
  --url https://api.ruxa.ai/api/v1/tasks/create \
  --header 'Authorization: Bearer sk-xxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "google/nano-banana",
    "input": {
      "prompt": "A futuristic cityscape at sunset, cyberpunk style",
      "output_format": "png",
      "image_size": "16:9"
    }
  }'

Response:

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

Query Task Status

After creating a task, query its status:

curl --request GET \
  --url 'https://api.ruxa.ai/api/v1/tasks/query/{taskId}' \
  --header 'Authorization: Bearer sk-xxxxxx'

Available Models

Model	Type	Description
`google/nano-banana`	Image	Gemini 2.5 Flash Image - fast text-to-image
`google/nano-banana-pro`	Image	Higher resolution with image editing
`sora-2`	Video	OpenAI Sora 2 - text/image to video
`sora-2-hd`	Video	Sora 2 HD - higher resolution output

Callback URL (Recommended)

For production, use callbacks instead of polling:

{
  "model": "google/nano-banana",
  "callBackUrl": "https://your-app.com/api/webhook",
  "input": {
    "prompt": "Your prompt here"
  }
}

The system will POST the result to your callback URL when generation completes.

Response Codes

Code	Description
200	Success
401	Unauthorized - invalid API key
402	Insufficient credits
422	Validation error
429	Rate limited
500	Server error

What is Ruxa AI?

API Endpoint

Authentication

Quick Start: Generate an Image

Query Task Status

Available Models

Callback URL (Recommended)

Response Codes

Next Steps

Author

Categories

Table of Contents

More Posts

Ruxa AI API Integration Best Practices

Sora 2 Video Generation API Guide

Nano Banana Image Generation API Guide

Newsletter