Image Remove Background API

Dokumentasi resmi Image Remove Background API dari Maelyn API untuk menghapus background gambar secara otomatis

Base Information

  • BASE_URL_API: https://api.maelyn.eu
  • Path / Endpoint: /ai/image/remove/background
  • Full URL: https://api.maelyn.eu/ai/image/remove/background
  • Method: POST
  • Credit Usage: 8

Authentication

Gunakan header berikut pada setiap request:

maelyn_auth: YOUR_API_KEY
Content-Type: application/json

Request Body

Endpoint ini digunakan untuk menghapus background dari gambar menggunakan AI.

{
  "image_url": "https://example.com/image.jpg"
}

Body Parameters

NameTypeRequiredDescription
image_urlstringYes*URL gambar yang ingin dihapus background-nya
urlstringYes*Alternatif dari image_url
imagestringYes*Alternatif dari image_url

Salah satu dari image_url, url, atau image wajib diisi.

Example Usage

{
  "image_url": "https://example.com/image.jpg"
}

Success Response

{
  "success": true,
  "result": {
    "url": "https://cdn.maelyn.eu/image/remove-bg.png",
    "size": "950.00 KB"
  }
}

Error Response

Invalid JSON

{
  "success": false,
  "error": "INVALID_JSON",
  "message": "Body request harus berupa JSON"
}

Image URL Required

{
  "success": false,
  "error": "IMAGE_URL_REQUIRED",
  "message": "Field image_url wajib diisi"
}

Invalid Image URL

{
  "success": false,
  "error": "INVALID_IMAGE_URL",
  "message": "Field image_url harus berupa URL gambar yang valid"
}

Image Download Failed

{
  "success": false,
  "error": "IMAGE_DOWNLOAD_FAILED",
  "message": "Gagal mendownload gambar"
}

Invalid Image Type

{
  "success": false,
  "error": "INVALID_IMAGE_TYPE",
  "message": "URL yang diberikan bukan file gambar"
}

Token Fetch Failed

{
  "success": false,
  "error": "WEBTOKEN_FETCH_FAILED",
  "message": "Gagal mengambil webtoken"
}

Remove Background Failed

{
  "success": false,
  "error": "REMOVE_BG_REQUEST_FAILED",
  "message": "Gagal memproses remove background"
}

Result Not Found

{
  "success": false,
  "error": "REMOVE_BG_RESULT_NOT_FOUND",
  "message": "Hasil gambar remove background tidak ditemukan"
}

Result Save Failed

{
  "success": false,
  "error": "RESULT_SAVE_FAILED",
  "message": "Terjadi gangguan saat menyimpan hasil gambar ke CDN"
}

Request Timeout

{
  "success": false,
  "error": "REMOVE_BG_REQUEST_TIMEOUT",
  "message": "Server remove background terlalu lama merespon"
}

Internal Server Error

{
  "success": false,
  "error": "INTERNAL_SERVER_ERROR",
  "message": "Terjadi kesalahan pada sistem"
}

Playground