Image Enhance & Restore

Image enhancement and restoration API reference. Upscale low-resolution images, remove noise and compression artifacts, restore damaged photographs, and optionally remove backgrounds in a single request.

Enhance & Restore

POST

/v1/tools/image-enhance/

Enhance image quality, remove visual artifacts, and optionally restore physical damage from old or worn photographs. The tool sharpens fine details, removes digital noise, JPEG compression blocks, grain, and banding. For damaged photos, it removes cracks, tears, scratch lines, fold marks, and stains — restoring background areas while leaving faces, skin, makeup, and original subjects completely unchanged. If the input image is smaller than 1024px, it is automatically scaled up before processing so the output is always usable. You can optionally remove the background in the same request and receive both results. Costs 15 credits per request. Adding background removal costs an additional 5 credits.

Request

# Enhance a photo
curl -X POST https://api.3daistudio.com/v1/tools/image-enhance/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/photo.jpg",
    "enhance": true,
    "mode": "enhance"
  }'

# Restore a damaged or old photograph
curl -X POST https://api.3daistudio.com/v1/tools/image-enhance/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/old-photo.jpg",
    "enhance": true,
    "mode": "restore"
  }'

# Enhance and remove background in one request
curl -X POST https://api.3daistudio.com/v1/tools/image-enhance/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/photo.jpg",
    "enhance": true,
    "mode": "enhance",
    "remove_bg": true,
    "remove_bg_quality": "high"
  }'

# Using a file upload
curl -X POST https://api.3daistudio.com/v1/tools/image-enhance/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F image_file=@photo.jpg \
  -F enhance=true \
  -F mode=restore \
  -F remove_bg=true \
  -F remove_bg_quality=medium

Response

{
  "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "created_at": "2026-02-25T12:00:00Z"
}

Parameters

Parameter	Type	Required	Description
image_url	string (URL)	Conditional	URL of the image to process. Required if image_file is not provided.
image_file	file	Conditional	Direct file upload. Supported formats: JPEG, PNG, WebP. Required if image_url is not provided.
enhance	boolean	No	Run image enhancement and restoration. Default: true.
mode	string	No	Enhancement mode. "enhance" for clean photos — improves sharpness, removes digital artifacts. "restore" for old or damaged photos — additionally removes cracks, tears, fold lines, and stains. Default: "enhance".
remove_bg	boolean	No	Remove the background and return a transparent PNG in addition to the enhanced image. Default: false.
remove_bg_quality	string	No	Background removal quality when remove_bg is true: "low", "medium", or "high". Default: "medium". See Remove Background for details on quality levels.

Credit Costs

Operation	Credits
Enhance only	15
Remove background only	5
Enhance + remove background	20

Checking Status

GET

/v1/generation-request/<task_id>/status/

Poll this endpoint with the task_id from the submit response. When status is "FINISHED", the results array contains the processed image or images. If both enhance and remove_bg were requested, two results are returned — one for the enhanced image and one for the background-removed version. Distinguish them using the result_type field in metadata. Results expire after 24 hours.

Request

curl https://api.3daistudio.com/v1/generation-request/YOUR_TASK_ID/status/ \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "status": "FINISHED",
  "progress": 100,
  "failure_reason": null,
  "results": [
    {
      "asset": "https://storage.3daistudio.com/assets/enhanced.jpg",
      "asset_type": "EDITED_IMAGE",
      "metadata": {
        "result_type": "enhanced"
      }
    },
    {
      "asset": "https://storage.3daistudio.com/assets/no-bg.png",
      "asset_type": "EDITED_IMAGE",
      "metadata": {
        "result_type": "background_removed"
      }
    }
  ]
}

Processing Times

Enhancement typically completes in 6–10 seconds. When background removal is also requested, expect 8–14 seconds total. Results are processed sequentially — enhancement runs first, then background removal.

What Gets Changed

Enhancement removes digital noise, grain, JPEG compression artifacts, banding, and pixelation. In restore mode, physical damage such as cracks, tears, scratch lines, fold marks, water stains, and age spots are also removed from background and non-subject areas. Faces, skin, makeup, hair, expressions, and clothing are never altered. Colors are preserved exactly — black and white or sepia images remain as they are.