API Documentation

Creatix API Documentation

Text‑to‑Image Generation API
Version v1

Overview

Creatix API is a REST API for generating images from text prompts. It is designed for marketing teams, developers, and platforms that need to generate large volumes of visual content automatically.

The API enables automated generation of marketing visuals, advertising creatives, product imagery, social media content, and promotional graphics.

Creatix API currently supports text‑to‑image generation only. Image editing, inpainting, outpainting, or multi‑turn generation flows are not supported.

All generated images include a visible Creatix watermark for copyright protection.

Base URL

Production endpoint:

https://api.creatix.ad

All endpoints are prefixed with /v1.

API Versioning

The Creatix API currently operates on version v1.

Future updates may introduce additional versions. Breaking changes will always be introduced through a new version rather than modifying existing endpoints.

Authentication

All API requests require an API key.

Include the API key in the Authorization header using the Bearer token format.

Example header:

Authorization: Bearer YOUR_API_KEY

API keys can be obtained by contacting sales manager at https://netsoftline.com.

Main Endpoint: Generate Images

POST /v1/images/generations

This endpoint generates one or more images based on a text prompt.

Request Parameters

Example Request (cURL)

curl -X POST https://api.creatix.ad/v1/images/generations
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{
  "prompt": "A majestic mountain landscape at sunset with a calm lake and pine trees, cinematic lighting",
  "n": 2,
  "size": "1024x1024",
  "aspect_ratio": "16:9"
}'

Example Successful Response

{
  "created": 1742138765,
  "data": [
    {
      "url": "https://cdn.creatix.ad/images/gen_abc123.png",
      "b64_json": null
    },
    {
      "url": "https://cdn.creatix.ad/images/gen_def456.png",
      "b64_json": null
    }
  ]
}

Working with Base64 Responses

If response_format is set to b64_json, the API returns image data encoded in base64 format.

This is useful for applications that want to process image data directly without downloading from a CDN.

Recommended Prompt Structure

High‑quality prompts significantly improve image generation results.

A good prompt typically includes subject, environment, style, lighting, and camera perspective.

Prompt Examples

Error Codes

Limits & Quotas

Python Example

import requests

url = "https://api.creatix.ad/v1/images/generations"
headers = {"Authorization":"Bearer YOUR_API_KEY","Content-Type":"application/json"}
payload = {"prompt":"Cyberpunk city at night","n":1,"size":"1024x1024"}

response = requests.post(url,headers=headers,json=payload)
print(response.json())

JavaScript Example

const response = await fetch("https://api.creatix.ad/v1/images/generations", {
  method:"POST",
  headers:{
    "Authorization":"Bearer YOUR_API_KEY",
    "Content-Type":"application/json"
  },
  body:JSON.stringify({
    prompt:"A cat astronaut floating in space",
    n:1,
    size:"1024x1024"
  })
})
const data = await response.json()
console.log(data)

Support & Resources

Dashboard and API keys: https://netsoftline.com

Email support: support@netsoftline.com

Live chat available on the official website.