REST API v1.0 • High Speed Engine

Developer Documentation & API Reference

Integrate ultra-fast AI image synthesis, 16:9 editorial banners, 8K photo renders, and automated visual workflows into your WordPress sites, Python scripts, webhooks, or custom SaaS apps.

⚡ Need a Developer API Key?
Create a free account to generate permanent API keys with daily quotas for your applications.
Sign Up Free →

REST API Endpoint

Send an HTTP POST request containing your JSON payload. Authentication can be passed via the Authorization: Bearer header, the X-API-Key header, or inside the JSON body.

POST https://createimage.in/api/v1/generate
Required Headers:
Content-Type: application/json
Authorization: Bearer <YOUR_API_KEY> (or X-API-Key: <YOUR_API_KEY>)

Ready-to-Run Code Examples

Select your programming language below. Copy and paste the snippet directly into your backend or automation workflow.

curl -X POST "https://createimage.in/api/v1/generate" \
  -H "Authorization: Bearer ci_live_YOUR_SECRET_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A futuristic Tokyo cyberpunk street at night, neon lights, 8k",
    "aspect_ratio": "16:9",
    "style": "article_banner"
  }'

Request Parameters

JSON body parameters supported by /api/v1/generate:

FIELD TYPE REQUIRED DEFAULT DESCRIPTION
prompt String Required The text prompt describing what you want to create (up to 2000 characters).
aspect_ratio String Optional "16:9" Dimensions: 16:9 (article header), 1:1 (square), 9:16 (reel/story), 4:3, 3:4.
style String Optional "article_banner" Visual Preset: article_banner, photorealistic, cinematic, anime, digital_art, 3d_render, cyberpunk, gov_scheme.
negative_prompt String Optional Attributes to avoid (e.g. blurry, low quality, distorted hands).
api_key String Optional Fallback API key parameter if you cannot send custom HTTP headers.

Sample JSON Response (200 OK)

{
  "success": true,
  "image_url": "https://createimage.in/images/demo/20260822_sample.jpg",
  "filename": "20260822_sample.jpg",
  "prompt": "A futuristic Tokyo cyberpunk street at night",
  "aspect_ratio": "16:9",
  "style": "article_banner",
  "user": {
    "email": "developer@example.com",
    "plan": "Free"
  },
  "quota": {
    "daily_limit": 10,
    "used_today": 0,
    "remaining": 10  },
  "created_at": "2026-08-22 23:45:01"
}

HTTP Status & Error Codes

Standard HTTP response codes returned by CreateImage.in API:

CODE STATUS DESCRIPTION & TROUBLESHOOTING
200 OK Success Image synthesized successfully. image_url contains the public direct link.
400 Bad Request Invalid Payload Missing prompt, empty body, or malformed JSON syntax.
401 Unauthorized Auth Failed Invalid or missing API key in Authorization header or request body.
429 Rate Limited Quota Exceeded Daily generation limit reached for your plan tier. Resets at 00:00 UTC or upgrade in pricing.
500 / 503 Cluster Timeout All Chrome warm workers are busy or prompt took longer than 120s. Implement retry logic.
Copied!