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.
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!