API Documentation

Integrate AI image enhancement into your applications with our simple REST API. Upload images, apply transformations, and retrieve results programmatically.

Quick Links

Authentication Upload Jobs Rate Limits

Authentication

All API requests require authentication using an API key. Include your key in theAuthorization header.

Get Your API Key

Sign in to your account (Pro tier or higher required)
Go to Settings → API Keys
Click "Create API Key" and save it securely

Important: Your API key is shown only once when created. Store it securely!

Authorization: Bearer sk_live_YOUR_API_KEY

Upload Image

Upload an image file to get a storage key for processing.

POST/api/v1/upload/api

Request

Send a multipart/form-data request with the image file.

Response

{
  "storage_key": "uploads/user-id/abc123.jpg",
  "filename": "image.jpg",
  "size": 1234567,
  "content_type": "image/jpeg"
}

curl -X POST "https://api.enhancecraft.com/api/v1/upload/api" \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -F "file=@/path/to/image.jpg"

Create Job

Create an image processing job with one or more operations.

POST/api/v1/jobs/api

Request Body

{
  "input_key": "uploads/user-id/image.jpg",
  "operations": [
    {
      "type": "enhance",
      "params": {
        "scale": 2
      }
    }
  ]
}

Available Operations

Type	Description	Parameters
enhance	AI upscaling for photos (2x, 4x, 8x)	scale (required: 2/4/8)
enhance-anime	AI upscaling optimised for anime, manga, and illustrations (always 4x)	none
enhance-face	Restore and sharpen faces in portraits and group photos	enhancement_level (optional, 0.0–1.0)
denoise	Remove noise and JPEG artifacts	enhancement_level (optional, 0.0–1.0)
deblur	Remove motion/focus blur and sharpen	strength (optional, 0.5–1.5)
restore-old-photo	Restore vintage photos — face repair, colorization, damage repair	face_enhancement_level (0.0–1.0), auto_repair_damage (bool), color_boost (1.0–2.0), enable_colorization (bool), colorization_strength (0.0–1.0)
remove-background	Remove image background with AI	output_format (optional: png/jpg)
replace-background	Replace background with a color, image, or AI-generated scene	background_type (required: color/image/transparent/prompt); background_color (#RRGGBB), background_image_key, or background_prompt depending on type
blur-background	Blur background while keeping subject sharp	blur_radius (optional, 1–100), output_format (optional: png/jpg)
smart-crop	AI-powered intelligent cropping to aspect ratio	aspect_ratio (optional: 1:1/4:3/16:9/9:16/3:2/2:3), padding_percent (optional, 0–30)
remove-object	Inpaint/remove objects from a masked region	mask_data_url (required, base64 data URL)
remove-text	Remove text and watermarks with AI	auto_detect (optional bool, default true); mask_data_url (required when auto_detect is false)
compress-optimize	Reduce file size via JPEG compression (free, no credits)	quality (optional, 1–100, default 85)
crop-resize	Crop and/or resize image (free, no credits)	crop {pixels: [x,y,w,h] or percentage: [x,y,w,h]}, resize {width, height, maintain_aspect}. At least one required.
convert	Convert image to a different format (free, no credits)	output_format (required: png/jpg/jpeg/webp), quality (optional, 1–100)

curl -X POST "https://api.enhancecraft.com/api/v1/jobs/api" \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_key": "uploads/user-id/image.jpg",
    "operations": [
      {"type": "enhance", "params": {"scale": 2}}
    ]
  }'

Get Job Status

Check the status of a processing job. Poll until status is completed or failed.

GET/api/v1/jobs/api/{job_id}

Response

{
  "id": "abc123-...",
  "status": "completed",  // queued, processing, completed, failed
  "input_url": "uploads/...",
  "output_url": "outputs/...",  // Available when completed
  "error_message": null,        // Error details if failed
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:15Z"
}

curl "https://api.enhancecraft.com/api/v1/jobs/api/JOB_ID" \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Rate Limits

API requests are rate limited based on your subscription tier.

Tier	Requests/Minute	Requests/Month	Max Keys
Pro	50	50,000	10
Business	200	200,000	50
Enterprise	10,000+	Unlimited	Unlimited

Rate Limit Headers

Every API response includes headers showing your current rate limit status:

X-RateLimit-Limit: 50         # Max requests per minute
X-RateLimit-Remaining: 45     # Requests remaining
X-RateLimit-Reset: 1705312800 # Unix timestamp when limit resets
X-RateLimit-Limit-Month: 50000
X-RateLimit-Remaining-Month: 49955

Complete Example

Here's a complete example that uploads an image, creates a job, and waits for completion.

# 1. Upload image
UPLOAD=$(curl -s -X POST "https://api.enhancecraft.com/api/v1/upload/api" \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -F "file=@image.jpg")
STORAGE_KEY=$(echo $UPLOAD | jq -r '.storage_key')

# 2. Create job
JOB=$(curl -s -X POST "https://api.enhancecraft.com/api/v1/jobs/api" \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"input_key\": \"$STORAGE_KEY\",
    \"operations\": [{\"type\": \"enhance\", \"params\": {\"scale\": 2}}]
  }")
JOB_ID=$(echo $JOB | jq -r '.id')

# 3. Poll for completion
while true; do
  STATUS=$(curl -s "https://api.enhancecraft.com/api/v1/jobs/api/$JOB_ID" \
    -H "Authorization: Bearer sk_live_YOUR_API_KEY" | jq -r '.status')
  echo "Status: $STATUS"
  if [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; then
    break
  fi
  sleep 2
done

Need Help?

Check our interactive API documentation for more details and try out endpoints directly.

Open Swagger UI