이미지배경 제거

배경 제거기

사진을 업로드하고 배경을 제거한 이미지를 다운로드하세요.

BiRefNet by Peng Zheng and contributors

모델 라이선스

BiRefNet standard 1024 ONNX exports · MIT

Retain the original copyright, MIT permission notice and warranty disclaimer with all copies or substantial portions.

포함된 라이선스

고지

무료온라인무제한BiRefNet by Peng Zheng and contributors API 액세스

API 레퍼런스

REST로 제출

개인 API 키(msk_…)를 사용하여 내 도구에서 이 워크로드의 작업을 생성하세요. 이렇게 시작한 작업은 내 기기에서 연결한 기기와 동일한 기기에서 실행되며, 최소 한 대는 온라인이어야 합니다.

API 세부 정보 숨기기
POSThttps://cp.meshlabs.cloud/v1/organizations/jobs

X-Organization-Api-Key: msk_your_personal_api_key로 인증합니다. 헤더 이름은 조직 키와 같으며, 개인 키도 같은 엔드포인트를 사용합니다.

입력 파일:같은 API 키로 POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign을(를) 호출하고, 반환된 upload_url에 파일을 업로드한 다음, job_spec에 download_url을(를) 전달하세요(예: input_image_url로).

요청 본문

{
  "workload_type": "birefnet-1024",
  "job_spec": {
    "input_image_url": "https://…/your-input.png",
    "resolution": 1024
  }
}

job_spec 필드

필드필수기본값설명
input_image_url예—입력 이미지의 사전 서명된 S3 URL

cURL

curl -X POST https://cp.meshlabs.cloud/v1/organizations/jobs \
  -H "X-Organization-Api-Key: msk_your_personal_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "workload_type": "birefnet-1024",
  "job_spec": {
    "input_image_url": "https://…/your-input.png",
    "resolution": 1024
  }
}'
GEThttps://cp.meshlabs.cloud/v1/organizations/jobs/{job_id}

status이(가) 최종 상태(COMPLETED, FAILED, CANCELED 또는 MODERATION_BLOCKED)가 될 때까지 같은 API 키로 폴링하세요. 콘텐츠 검토가 활성화된 경우, 작업은 컴퓨팅 대기열에 들어가기 전에 MODERATION_PENDING 상태로 시작할 수 있습니다. 완료된 작업의 각 출력에는 사전 서명된 download_url 값이 포함됩니다.

생성 응답

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "workload_type": "birefnet-1024",
  "status": "PENDING",
  "job_spec_json": {
    "input_image_url": "https://…/your-input.png",
    "resolution": 1024
  },
  "work_units": [],
  "outputs": [],
  "created_at": "2026-06-08T12:00:00Z",
  "updated_at": "2026-06-08T12:00:00Z"
}

완료 응답

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "workload_type": "birefnet-1024",
  "status": "COMPLETED",
  "job_spec_json": {
    "input_image_url": "https://…/your-input.png",
    "resolution": 1024
  },
  "work_units": [
    {
      "id": "…",
      "index": 0,
      "status": "COMPLETED"
    }
  ],
  "outputs": [
    {
      "id": "…",
      "output_type": "<output type>",
      "filename": "<output filename>",
      "size_bytes": 524288,
      "download_url": "<presigned output download URL>"
    }
  ],
  "created_at": "2026-06-08T12:00:00Z",
  "updated_at": "<completion timestamp>"
}

사진을 업로드하면 배경이 제거된 누끼 이미지를 다운로드할 수 있습니다. 연결한 기기에서 무료로 배경을 제거하세요. 처음 실행할 때는 모델을 내려받으며, 이후 사진은 더 빠르게 시작됩니다.