เอกสาร API ลบพื้นหลัง

ส่งภาพและรับ PNG โปร่งใสด้วยคีย์ API เดียว

POSThttps://api.remox.ai/v1.0/removebg

เริ่มต้นใช้งาน

ขอใช้งาน API →

เก็บคีย์ที่ได้รับบนเซิร์ฟเวอร์ อย่าเปิดเผยในเบราว์เซอร์หรือแอป การเปลี่ยนคีย์จะคงตัวตนและยอดคงเหลือของลูกค้า

REMOX_API_KEY

ใช้ JPG, PNG หรือ WebP แบบภาพนิ่ง ปรับขนาดก่อนอัปโหลด API ไม่ปรับขนาดภาพ

ตัวอย่างโค้ด →

การยืนยันตัวตน

ฟิลด์	ค่าที่รองรับ
X-API-Key	remox_live_… / remox_test_…
Secret / X-Subuid / X-Platform-User / X-RapidAPI-User	—
image_url / Base64 / shadow / refine	—

ตัวอย่างโค้ด

cURL

# Set REMOX_API_KEY in your environment first.
curl 'https://api.remox.ai/v1.0/removebg' \
  -H "X-API-Key: $REMOX_API_KEY" \
  -H 'Idempotency-Key: image-0001' \
  -F 'image_file=@/path/to/input.jpg' \
  -F 'size=auto' \
  --max-time 75 --fail-with-body \
  -D response-headers.txt -o remox-result.png
# On non-2xx, the output file contains error JSON, not a PNG.

ใช้ JPG, PNG หรือ WebP แบบภาพนิ่ง ปรับขนาดก่อนอัปโหลด API ไม่ปรับขนาดภาพ

input.jpg → image/jpeg · PNG → image/png · WebP → image/webp

ข้อมูลคำขอ

POST /v1.0/removebg · multipart/form-data

ใช้ JPG, PNG หรือ WebP แบบภาพนิ่ง ปรับขนาดก่อนอัปโหลด API ไม่ปรับขนาดภาพ

ฟิลด์	จำเป็น	ค่าที่รองรับ
image_file	✓	JPG / PNG / WebP · ≤20 MiB (20 × 1024 × 1024 bytes) · max(width, height) ≤1920 px · min(width, height) ≤1080 px
size	—	auto
response_format	—	image / json
Idempotency-Key	—	8–128 · A–Z a–z 0–9 . _ : -

การตอบกลับ

200 · PNG

response_format=image · Content-Type: image/png

X-Request-ID · X-Task-ID · X-Idempotency-Key

200 · JSON

response_format=json

{
  "requestId": "req_…",
  "taskId": "task_…",
  "data": {
    "result_url": "https://storage.example/result.png?signature=…&expires=…"
  }
}

data.result_url ≠ result_b64

หมดเวลาและลองใหม่

หลัง 60 วินาที 504 อาจหมายถึงงานยังทำงานอยู่ ตรวจสถานะหรือลองใหม่ด้วยภาพและ Idempotency-Key เดิมเพื่อเลี่ยงการคิดเงินซ้ำ

GET /v1.0/tasks/{taskId}

{
  "requestId": "req_…",
  "taskId": "task_…",
  "status": "completed",
  "progress": null,
  "pollAfterMs": 2000,
  "result": {
    "downloadPath": "/v1.0/tasks/task_…/result",
    "mimeType": "image/png",
    "expiresAt": "2026-10-17T00:00:00.000Z"
  }
}

GET /v1.0/tasks/{taskId}/result
GET /v1.0/tasks/{taskId}/result?response_format=json

creating → queued → processing → completed / failed / timed_out

Retry-After · pollAfterMs: 2000 · X-API-Key

บัญชีและเครดิต

เครดิตถูกจองเมื่อสร้างงาน ใช้เมื่อสำเร็จ และคืนเมื่อล้มเหลวหรืองานหมดอายุ การหมดเวลารอแบบซิงโครนัสไม่คืนเครดิต

ฟิลด์	ค่าที่รองรับ
credits	available / reserved / consumed
GET /v1.0/account	X-API-Key
POST → AI	300 ms
POST → 504	60 s
task → timed_out	35 min
task_expired	90 d
result_expired (Worker)	7 d

ข้อผิดพลาด

ตรวจ errors และสถานะงานก่อนลองใหม่ เก็บ requestId สำหรับฝ่ายสนับสนุน อย่าบันทึกคีย์

{
  "requestId": "req_…",
  "retryable": false,
  "errors": [
    {
      "code": "invalid_credentials",
      "title": "Invalid API key."
    }
  ]
}

HTTP	errors[].code	ข้อผิดพลาด
400	invalid_request, invalid_file	คำขอไม่ถูกต้อง
400	invalid_size, invalid_response_format	คำขอไม่ถูกต้อง
400	invalid_idempotency_key, invalid_subject	คำขอไม่ถูกต้อง
402	insufficient_credits	เครดิตไม่เพียงพอ
403	invalid_credentials	ปฏิเสธการเข้าถึง
403	platform_disabled, platform_paused, scope_denied	ปฏิเสธการเข้าถึง
404	not_found, upload_not_found	ไม่พบข้อมูล
409	idempotency_conflict	ขัดแย้งหรืองานยังไม่เสร็จ
409	result_not_ready	ขัดแย้งหรืองานยังไม่เสร็จ
410	task_expired, result_expired	หมดอายุ
413	file_too_large	ไฟล์ใหญ่เกินไป
415	invalid_image, animated_image_unsupported	ไม่รองรับภาพ
422	image_dimensions_exceeded	ขนาดภาพเกินกำหนด
429	rate_limit_exceeded, hourly_quota_exhausted, inflight_limit_exceeded	เกินขีดจำกัดคำขอ
502	upload_failed, upstream_rejected, upstream_unavailable	บริการต้นทางล้มเหลว
502	create_result_unknown, remote_service_error, invalid_result, result_unavailable, task_failed, task_timeout	บริการต้นทางล้มเหลว
503	service_not_configured, credit_price_not_configured, server_error	บริการไม่พร้อมใช้งาน
504	sync_timeout	หมดเวลารอแบบซิงโครนัส

retryable: 429 / 5xx

ความเข้ากันได้

รองรับเฉพาะลบพื้นหลังด้วยคีย์เดียว ไม่รองรับทุกตัวเลือกของ remove.bg URL ผลลัพธ์ JSON เป็นส่วนขยาย REMOX

ขอใช้งาน API →