---
description: Clearcut export an edited image. Learn how to remove image backgrounds, manage jobs and work with credits in your application.
title: Export an edited image | Clearcut
image: https://clearcut.sh/og/docs.png
---

GUIDES

[Quick start](https://clearcut.sh/docs)[Authentication](https://clearcut.sh/docs/authentication)[Credits & billing](https://clearcut.sh/docs/credits)[Limits & retries](https://clearcut.sh/docs/limits)[Examples](https://clearcut.sh/docs/examples)[Errors](https://clearcut.sh/docs/errors)

API REFERENCE

[POSTRemove a background](https://clearcut.sh/docs/remove-background)[GETremove.bg account info](https://clearcut.sh/docs/removebg-account)[POSTCreate an image job](https://clearcut.sh/docs/create-job)[GETGet a job](https://clearcut.sh/docs/get-job)[GETList images](https://clearcut.sh/docs/list-jobs)[DELETEDelete an image](https://clearcut.sh/docs/delete-job)[GETDownload a result](https://clearcut.sh/docs/download)[POSTExport an edited image](https://clearcut.sh/docs/export)[POSTUpload a background](https://clearcut.sh/docs/background)[POSTExport a ZIP batch](https://clearcut.sh/docs/batch-export)[POSTCopy a batch background](https://clearcut.sh/docs/batch-background)[POSTSmart Brush](https://clearcut.sh/docs/smart-brush)[POSTGenerate a scene](https://clearcut.sh/docs/generate-scene)[GETCredit balance](https://clearcut.sh/docs/account)[POSTRetry a failed image](https://clearcut.sh/docs/retry-job)[GETRecent usage](https://clearcut.sh/docs/usage)[Download OpenAPI](https://clearcut.sh/openapi.json)

API reference / Export an edited image

# Export an edited image

Render a finished image using the same settings as the editor. Export uses no extra credits. Add ?prepare=true to receive a private download URL.

POST`/api/jobs/{id}/export`

Authenticate with `X-API-Key`. Keep your key on your server; never embed it in a public website.

## Request parameters

`format`stringdefault: png

Output format.

`png` `jpg` `webp`

`size`stringdefault: full

Output dimensions.

`full` `preview`

`settings`object

Editor settings. See the edit example.

`background`string

An included background path or a background URL returned for this job.

`mask`string

Optional Base64 PNG alpha mask from the manual brush.

## Editor settings

Pass these inside `settings`. Omitted fields use the defaults below. Preset canvases are limited to 4096 pixels per side; the original ratio preserves the source size.

| Field                              | Default           | Values                                                           |
| ---------------------------------- | ----------------- | ---------------------------------------------------------------- |
| bgMode                             | transparent       | transparent, color, gradient, photo, original                    |
| bgColor / bgColor2                 | #ffffff / #f3e5cd | Hex colors for solid / gradient backgrounds                      |
| blur                               | 0                 | 0–40; background blur                                            |
| shadow                             | 0                 | 0–100; opacity percentage                                        |
| shadowType                         | drop              | drop, ground, car                                                |
| ratio                              | original          | original, square, portrait (4:5), story (9:16), landscape (16:9) |
| scale                              | 100               | 10–200 percent                                                   |
| offsetX / offsetY                  | 0                 | −100 to 100 percent of canvas                                    |
| rotation                           | 0                 | −180 to 180 degrees                                              |
| flip                               | false             | Boolean; horizontal flip                                         |
| brightness / contrast / saturation | 100               | 0–200 percent                                                    |
| text                               | empty             | Caption, up to 500 characters                                    |
| textSize                           | 48                | 10–150; scaled with canvas size                                  |
| textColor                          | #ffffff           | Caption hex color                                                |
| textY                              | 85                | 0–100 percent; vertical caption position                         |

## Response

200 · Success

{
  "binary": "Rendered image bytes"
}

Errors use a structured `error.code` and `error.message`. [See error handling →](https://clearcut.sh/docs/errors)

## Example request

Replace IMAGE\_ID with your job ID. This example calls the endpoint shown here.

cURLPythonNode.js

```
curl https://clearcut.sh/api/jobs/IMAGE_ID/export \
  -X POST -H "X-API-Key: $CLEARCUT_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"format":"png","size":"full","settings":{"bgMode":"color","bgColor":"#ffffff","ratio":"square"}}' -o result.png
```

[More examples →](https://clearcut.sh/docs/examples)

Need help?

Prefer email? [support@clearcut.sh](mailto:support@clearcut.sh)

Export an edited image | Clearcut

```json
{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://clearcut.sh/#organization","name":"Clearcut","url":"https://clearcut.sh","logo":"https://clearcut.sh/apple-touch-icon.png","email":"support@clearcut.sh","description":"An independent image background removal service operated by chern0.dev.","contactPoint":{"@type":"ContactPoint","email":"support@clearcut.sh","contactType":"customer support"}},{"@type":"WebSite","@id":"https://clearcut.sh/#website","url":"https://clearcut.sh","name":"Clearcut","description":"Remove image backgrounds with Clearcut. Get 30 free credits every month for the website and API. Full-resolution downloads, no watermark. Packs from $3.","inLanguage":"en","publisher":{"@id":"https://clearcut.sh/#organization"}}]}
```