# Cutout Image — Zapi reference

> Upload gambar ke S3 presigned URL (3 jam). Khusus image.

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys.
**Response envelope:** `{ status, message, content }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/uploader/cutout
- Endpoint catalog: https://zpi.web.id/category/uploader
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## Cutout Image

**Category:** uploader · **Slug:** `cutout`
**Detail page:** https://zpi.web.id/api/uploader/cutout

Upload gambar ke S3 presigned URL (3 jam). Khusus image.

**Tags:** upload, image

### Upload File

Upload gambar ke S3 presigned URL (3 jam). Khusus image.

- **Method:** `POST`
- **Endpoint:** `https://api.zpi.web.id/v1/uploader:cutout/upload`

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `file` | file | form | yes | Gambar (jpg/png/webp). Khusus image, expire 3 jam. |

**cURL:**
```bash
curl -X POST "https://api.zpi.web.id/v1/uploader:cutout/upload" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "file": "photo.jpg"
}'
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/uploader:cutout/upload", {
  method: "POST",
  headers: { "x-api-key": process.env.ZAPI_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
  "file": "photo.jpg"
})
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.post("https://api.zpi.web.id/v1/uploader:cutout/upload",
  headers={"x-api-key": "YOUR_API_KEY"},
  json={
  "file": "photo.jpg"
})
data = r.json()
```

**Example response:**
```json
{
  "mime": "image/jpeg",
  "note": "Presigned URL valid 3 jam. Hanya untuk gambar.",
  "service": "cutout",
  "fileName": "96fc0fc145454ad9457b51e17ae68a55.jpg",
  "fileSize": 67105,
  "expiresAt": "2026-05-23T12:36:21.692Z",
  "expiresIn": "3h",
  "publicUrl": "https://deeplor.s3.us-west-2.amazonaws.com/upload/2026/05/23/8abfed491b2d4a50ab02adf20d05a3cf.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20260523T093621Z&X-Amz-SignedHeaders=host&X-Amz-Expires=10800&X-Amz-Credential=AKIAROYXHKZU6F6BHMXV%2F20260523%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Signature=c92dba3afc5c7c0befc6b1864c0542625afb7873be5ed110681827cbb277569d",
  "uploadedAt": "2026-05-23T09:36:21.692Z",
  "oneTimeDownload": false
}
```

---


_Generated: 2026-08-02T14:23:46.888Z_