Novassium API Documentation

Last Updated: September 21, 2025

Welcome to the Novassium API! This documentation provides everything you need to integrate state-of-the-art AI image generation directly into your applications and workflows.

---

Quickstart Guide (5 Minutes)

Get your first AI-generated image in just a few steps.

1. Get Your API Key

Find your unique API key in your Novassium Dashboard. You'll need an active subscription to a qualifying plan.

2. Make Your First Request

Use the following cURL command in your terminal. Replace your_unique_api_key_here with your actual key.

curl -X POST \
  https://proxyle.com/api/novassium/v1/generate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_unique_api_key_here" \
  -d '{
    "prompt": "A photorealistic image of a majestic lion in the savannah at sunset",
    "style_preset": "photographic",
    "aspect_ratio": "16:9",
    "samples": 1,
    "output_format": "jpeg"
  }'

3. Receive Your Image

If successful, you'll receive a JSON response containing the URL of your newly generated image.

{
    "success": true,
    "images": [
        "https://proxyle-media.s3.amazonaws.com/file/photo-realistic-lion-in-the-savannah.png"
    ],
    "remaining_credits": 999
}

---

Authentication

All requests to the Novassium API must be authenticated. Pass your API key in the X-API-Key header with every request.

Header Format: X-API-Key: your_unique_api_key_here

Security Notice: Your API key is a secret. Do not expose it in client-side code or public repositories. We recommend storing it securely in an environment variable.

---

API Endpoint Reference

Generate Image

Generates a unique, AI-powered image based on your specifications.

POST https://proxyle.com/api/novassium/v1/generate

Request Parameters

Parameter	Type	Required	Description
prompt	string	Yes	A detailed text description of the desired image.
style_preset	string	Yes	The artistic style to apply. See accepted values below.
aspect_ratio	string	Yes	Accepted values: 1:1, 2:3, 16:9.
samples	integer	Yes	Number of images to generate. Must be set to 1.
output_format	string	Yes	Accepted values: png, jpeg, webp.
negative_prompt	string	No	A description of elements to exclude from the image.
seed	integer	No	A number between 0 and 4294967294 for reproducible results.
width	integer	No	Image width in pixels (64 - 16384). Defaults to 1024.
height	integer	No	Image height in pixels (64 - 16384). Defaults to 1024.

Accepted style_preset Values:

enhance, anime, photographic, digital-art, comic-book, fantasy-art, line-art, analog-film, neon-punk, isometric, low-poly, origami, modeling-compound, cinematic, 3d-model, pixel-art, tile-texture

Example Request (JSON Body):

{
    "prompt": "The exterior of a beautiful royal mansion, cinematic style",
    "style_preset": "cinematic",
    "aspect_ratio": "16:9",
    "samples": 1,
    "negative_prompt": "No modern cars or people",
    "seed": 987654321,
    "output_format": "png",
    "width": 1920,
    "height": 1080
}

Successful Response (200 OK)

{
    "success": true,
    "images": [
        "https://proxyle-media.s3.amazonaws.com/file/a-beautiful-royal-mansion.png"
    ],
    "remaining_credits": 997
}

---

Error Handling & Rate Limiting

The API uses standard HTTP status codes for success and failure.

Rate Limits

To ensure service stability for all users, the API is rate-limited:

• 100 requests per hour
• 2,400 requests per day

Exceeding these limits will result in a 429 Too Many Requests error.

Common HTTP Status Codes

Status Code	Error Message	Reason
400 Bad Request	Prompt is required.	A required parameter is missing or invalid.
401 Unauthorized	API key is missing.	The X-API-Key header was not included.
403 Forbidden	Invalid API key.	The provided API key is incorrect or disabled.
403 Forbidden	No active subscription.	The user's plan is inactive or does not grant API access.
429 Too Many Requests	Rate limit exceeded.	You have sent too many requests in a given time frame.
500 Internal Server	Server error.	An unexpected error occurred on our end. Please try again or contact support.

Example Error Response (400 Bad Request)

{
    "success": false,
    "message": "Invalid value for style_preset. Please check accepted values."
}

---

Resources & Guides

Testing with Postman

1. Set Method & URL: Create a new request with method POST and URL https://proxyle.com/api/novassium/v1/generate.
2. Add Headers: In the Headers tab, add two keys: Content-Type with value application/json, and X-API-Key with your API key as the value.
3. Set Body: In the Body tab, select raw and JSON. Paste your request parameters as a JSON object.
4. Send: Click "Send" to execute the request and view the response.

API Key Management

You can regenerate your API key at any time from your Novassium dashboard. Regenerating a key will immediately invalidate the old one. Remember to update all of your applications with the new key.

Frequently Asked Questions (FAQs)

• Which plans include API access?
  API access is available on the Novice, Creator, Artist, Ninja, Ranger, and Titan plans.
• How do API credits work?
  Each image generation consumes one credit from your monthly allowance.
• Where can I get the Novassium WordPress plugin?
  You can download the official plugin here.

For further assistance, please contact our support team at support@proxyle.com.