Renderonix API Documentation

Generate high-quality AI images using Renderonix API with just a few lines of code. Our API is designed for simplicity and powerful integration.

If you want to integrate Renderonix AI into your applications, contact us to get access to the API: shaan81290@gmail.com

API Endpoint

All API requests should be made to the following endpoint:

POST https://renderonix.com/api_generate.php

Required Headers

Ensure these headers are included with every API request for authentication and content type:

Content-Type: application/json
X-API-TOKEN: YOUR_API_TOKEN

• Content-Type: application/json: Specifies that the request body is in JSON format.
• X-API-TOKEN: YOUR_API_TOKEN: Your unique API token for authentication. Replace YOUR_API_TOKEN with your actual token.

Request Body (JSON)

The request body should be a JSON object containing the following parameters:

{
  "prompt": "a futuristic warrior girl in glowing armor, cyberpunk city background, neon lights, highly detailed, cinematic lighting",
  "aspect": "2:3",
  "quantity": 2
}

• prompt – (string, required) The text description for the image you want to generate. Be descriptive for best results.
• aspect – (string, required) The desired aspect ratio of the image. Refer to the supported aspect ratios for available options.
• quantity – (integer, optional, default: 1) Number of images to generate (1 to 4). Each image costs 1 credit.

cURL Example

Here's an example of how to make a request using cURL:

curl -X POST https://renderonix.com/api_generate.php \
  -H "Content-Type: application/json" \
  -H "X-API-TOKEN: YOUR_API_TOKEN" \
  -d '{
    "prompt": "a futuristic warrior girl in glowing armor, cyberpunk city background, neon lights, highly detailed, cinematic lighting",
    "aspect": "2:3",
    "quantity": 2
  }'

Sample Success Response

A successful request will return a JSON object similar to this, containing URLs to your generated images and credit information:

{
  "images": [
    "https://renderonix.com/i/a1b2c3",
    "https://renderonix.com/i/d4e5f6"
  ],
  "used": 2,
  "credits_left": 3,
  "width": 768,
  "height": 1152,
  "status": "success"
}

• images – (array of strings) An array of URLs to the generated images.
• used – (integer) Number of credits used for this specific request.
• credits_left – (integer) Remaining credits in your account after the transaction.
• width – (integer) Width of the generated images in pixels.
• height – (integer) Height of the generated images in pixels.
• status – (string) Indicates the request status (e.g., "success").

Error Responses

In case of an error, the API will return a JSON object with a status of "error" and a descriptive message:

{
  "status": "error",
  "message": "Invalid API token. Please check your token and try again."
}

{
  "status": "error",
  "message": "Insufficient credits. Please top up your account."
}

• status – (string) Always "error" for failed requests.
• message – (string) A detailed message explaining the error.

Supported Aspect Ratios

To fetch the most current list of all supported aspect ratios and their corresponding dimensions, make a GET request to this endpoint:

GET https://renderonix.com/aspect_ratios.php

Important Notes

• Each image generation deducts 1 credit from your account.
• Generated image links are short, publicly accessible, and expire within 1 hour for security and storage optimization. Make sure to download or process them promptly.
• Only valid and active API tokens can access this endpoint. Ensure your token is correct and has sufficient credits.

Need further assistance or have questions? Contact our support team!