Background Removal
DRAEVA / Public API
POST /bg/v1/background-removals
Scope: background-removal:process
Scope: background-removal:process
Multipart request
POST /bg/v1/background-removals HTTP/1.1
Host: api.getdraeva.com
Authorization: Bearer YOUR_DRAEVA_API_KEY
Content-Type: multipart/form-data; boundary=...
| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
image | file | Evet | JPEG, PNG veya WebP |
curl -X POST https://api.getdraeva.com/bg/v1/background-removals \
-H "Authorization: Bearer YOUR_DRAEVA_API_KEY" \
-F "image=@garment.jpg" \
--output result.png
JSON/base64 request
POST /bg/v1/background-removals?return_base64=true
Content-Type: application/json
{ "image_base64": "iVBORw0KGgo..." }
image_base64, ham base64 veya data:image/...;base64, önekli olabilir. Base64 response anahtar config'inde kapalıysa bu modu kullanmayın. Base64, binary'ye göre yaklaşık %33 payload ek yükü oluşturur.
Başarılı yanıtlar
Varsayılan binary
HTTP/1.1 200 OK
Content-Type: image/png
X-Request-Id: 01J...
Body, şeffaf PNG byte'larıdır. İstemci başarılı response'un hem Content-Type değerini hem PNG imzasını doğrulamalıdır.
Base64
{ "image_base64": "iVBORw0KGgo..." }
Endpoint'e özel hatalar
| HTTP | Problem | Açıklama |
|---|---|---|
| 400 | invalid-request | Multipart/JSON şekli bozuk veya image eksik |
| 413 | payload-too-large | Byte ya da piksel tavanı aşıldı |
| 415 | unsupported-media-type | Magic byte desteklenmiyor |
| 429 | rate-limit-exceeded / quota-exceeded | Hız veya günlük kota |
| 502 | upstream-failed | Görsel işleme bağımlılığı hata verdi |
| 503 | upstream-unavailable | Model/bağımlılık hazır değil |
Güvenlik
- Dosya adını güvenilir path olarak kullanmayın.
- Response'u kalıcı depolayacaksanız kendi veri saklama ve silme politikanızı uygulayın.
- Görsel byte/base64 içeriğini loglamayın.
- Request body'yi DRAEVA'ya göndermeden önce kendi hosting limitinizle daha düşük bir tavan uygulayın.