Bria
BRIA Eraser
bria-eraser
마스크 영역 제거와 영역 재구성에 집중하는 이미지 편집 모델로, 흑백 마스크에 따라 대상 객체를 제거하고 화면을 보완하며, 라이선스가 허여된 데이터로 학습되어 이커머스와 마케팅 소재의 대량 정리에 적합합니다
가격
bria-eraser per image
| 단가 | $0.0575 |
|---|
포지셔닝 소개
BRIA Eraser는 지우기(erase)에 특화된 이미지 편집 모델입니다. 원본 이미지와 흑백 마스크를 입력하면 흰색으로 표시된 영역이 제거 대상이 되며, 모델이 대상 객체를 제거하고 가려진 픽셀을 재구성하여 원래 해상도를 유지한 깨끗한 이미지를 출력합니다. 잡동사니 제거, 임시 요소 제거를 배치 콘텐츠 파이프라인에 통합하려는 개발자, 특히 소재 라이선스 출처에 민감하고 결과물을 바로 상품화하거나 후반 작업 공정에 투입해야 하는 이커머스·광고·컨셉 디자인 팀에 적합합니다.
핵심 하이라이트
- 지우기와 영역 재구성에 집중——단 한 가지 일만 수행합니다. 마스크에 따라 대상을 제거하고 배경을 보완하며, 프로세스가 단순하여 기존 이미지 처리 파이프라인에 쉽게 연결할 수 있습니다.
- 출력 시 원래 해상도 유지——결과가 입력 이미지 크기를 그대로 따르므로 크기 복원이 필요 없고, 후속 레이아웃이나 상품 등록 공정에 바로 투입할 수 있습니다.
- 사용성 우선의 입력 제약——JPEG, PNG, WEBP 공개 이미지와 동일 비율의 흑백 마스크를 지원하며, 파라미터를 통해 투명 채널을 유지할 수 있습니다.
기능 설명
마스크 기반 객체 지우기: 원본과 동일 비율의 흑백 마스크로 제거할 객체를 지정합니다. 흰색은 지우기 영역, 검은색은 유지 영역이며, 화면에서 지정된 요소를 정밀하게 제거하는 데 적합합니다.
지운 영역의 픽셀 재구성: 제거된 영역에 콘텐츠를 보완하고 배경 구조를 재구성하여, 객체를 제거한 화면에 눈에 띄는 빈틈이 남지 않게 하여 수작업 보정을 줄입니다.
출력 해상도 정합: 출력이 입력 이미지 해상도를 그대로 따르므로 결과물로 원본 소재를 바로 대체할 수 있어 2차 스케일링과 정렬 단계를 생략할 수 있습니다.
투명 채널 유지: preserve_alpha를 활성화하면 알파 채널이 있는 입력이 결과에서도 계속 투명하게 유지되어, 레이어 소재 정리에 적합합니다.
마스크 소스 적응: mask_type으로 수작업 마스크와 분할 도구가 생성한 마스크를 구분할 수 있어, 자동 분할 결과를 지우기 프로세스에 바로 연결할 수 있습니다.
적용 시나리오
- 이커머스 운영의 상품 이미지 잡동사니 제거——상품 대표 이미지와 잡동사니·임시 요소를 표시한 마스크를 입력하여 깨끗한 상품 화면을 얻고, 상세 페이지와 상품 등록에 바로 사용할 수 있습니다.
- 광고 소재 후반 작업의 화면 정리——광고 소재에서 불필요한 사물을 국소적으로 지워 레이아웃과 광고 집행을 이어갈 수 있는 완성 이미지를 얻어 수작업 보정의 반복을 줄입니다.
- 컨셉 디자인의 국소 보정——캐릭터 원화나 장면 스케치와 국소 마스크를 입력하여 불필요한 획이나 요소를 제거하고, 추가 드로잉을 이어갈 수 있는 기본 이미지를 출력합니다.
- 배치 콘텐츠 처리 파이프라인——자동 분할로 생성된 마스크를 일괄적으로 지우기 단계에 투입하여 규격이 통일된 정리된 소재를 얻고, 기존 검토 및 반복 공정에 연결합니다.
제한 사항 및 선택 가이드
효과는 마스크 품질에 크게 의존합니다. 마스크 비율은 원본과 일치해야 하고, 가장자리는 대상 객체보다 약간 넓게 잡아야 잔여물이나 잘못된 삭제를 피할 수 있습니다. 모델은 지우기와 영역 보완만 다루며 범용 이미지 생성 기능은 제공하지 않으므로, 처음부터 이미지를 생성해야 하는 시나리오에는 다른 모델을 선택해야 합니다. 또한 공개 인터넷에서 접근 가능한 이미지 URL만 허용하고 결과는 원래 해상도를 유지하므로, 강한 실시간 상호작용이 필요한 호출 시나리오에는 적합하지 않습니다.
새소식
변경 이력 보기 →- 새 모델 신규 모델 bria-eraser 마스크 지우기
자주 묻는 질문
모든 질문 보기 →-
마스크는 어떻게 그리나요?
마스크는 흑백 이미지입니다. 흰색 영역은 지워지고 배경으로 채워지며, 검은색 영역은 그대로 유지됩니다. 흰색 범위는 물체 가장자리보다 약간 크게 잡는 것이 좋으며, 이렇게 하면 그림자와 가장자리 잔여물도 함께 제거할 수 있습니다.
-
마스크는 반드시 원본 이미지와 크기가 같아야 하나요?
마스크의 가로세로 비율은 원본 이미지와 일치해야 하며, 지우기 위치가 어긋나지 않도록 원본 이미지 크기 그대로 내보내는 것을 권장합니다.
-
프롬프트를 작성해야 하나요?
아니요. Bria Eraser는 원본 이미지와 마스크만으로 작동하며, 요청에 prompt 필드를 포함할 수 없습니다.
-
mask_type은 manual과 automatic 중 무엇을 선택해야 하나요?
브러시나 이미지 편집 소프트웨어로 직접 칠해 만든 마스크는 manual(기본값)을 선택하고, 세그멘테이션 도구가 자동으로 생성한 마스크는 automatic을 선택하세요.
생성 작업 제출
https://api.hiapi.ai/v1/tasks 헤더
Authorizationstring필수계정 API 키. 모든 요청에 필수입니다. 예: Bearer YOUR_HIAPI_API_KEY. API 키 받기
Content-Typestring선택요청 본문은 항상 JSON으로 파싱됩니다. 전송 시 application/json(charset 포함 가능)만 허용되며, 다른 값은 415를 반환합니다. 예: application/json.
Idempotency-Keystring선택멱등 키. 최대 255바이트. 같은 계정에서 같은 키의 재시도는 태스크를 한 번만 생성하며, 재전송 시 최초의 taskId를 반환합니다.
네트워크 타임아웃이나 클라이언트 자동 재시도 시 같은 키로는 태스크를 한 번만 생성하고 이중 과금되지 않습니다(범위 = API 키의 계정). 업무 고유 식별자(예: "order-42")를 키로 사용할 것을 권장합니다. 같은 키 재전송 시 최초 taskId를 반환하며, 키는 첫 제출 후 24시간 뒤 만료됩니다. 자세한 시나리오 표는 통합 비동기 API 소개 페이지를 참고하세요.
본문
modelstring필수현재 고정 값: bria-eraser
routestring선택현재 고정 값: default
inputobject필수
bria-eraser 및 루트 default의 비즈니스 파라미터 객체. 아래 파라미터 표를 참조하세요.
mask_urlstring필수minLength 1pattern ^https?://Black-and-white mask with the same aspect ratio as the image: white marks what to erase, black is kept. Paint slightly beyond the object edge.
image_urlstring필수minLength 1pattern ^https?://Public URL of the image to clean up (JPEG, PNG or WEBP). The result keeps the original resolution.
mask_typestring선택기본값: "manual"manual for brush-drawn masks; automatic for masks produced by a segmentation tool.
manualautomaticpreserve_alphaboolean선택기본값: falseIf the input has an alpha channel, keep its transparency in the result.
callbackobject선택
종료 상태 알림 설정. 생략하면 콜백이 전송되지 않으며 호출 측에서 폴링합니다.
생성 시 callback.url을 지정하면 태스크 종료 시 HiAPI가 서비스로 POST하여 폴링이 필요 없습니다. 콜백 본문은 태스크 상세와 동일한 구조입니다. 서명 검증·재시도·멱등에 대한 자세한 내용은 통합 비동기 API 소개 페이지의 콜백 설명을 참고하세요.
urlstring필수callback 사용 시 필수. 태스크 종료 후 이 URL로 POST됩니다. 유효한 http(s) URL이어야 합니다.
whenstring선택기본값: "final"현재는 final만 지원(success / fail 모두 알림).
finalstoragestring선택기본값: "temp"산출물 저장 등급: temp(기본·약 7일) 또는 persistent(장기 보관·용량 과금). 잔액 부족이나 저장 한도 초과 시 자동으로 temp로 강등됩니다. 실제 적용된 등급은 태스크 상세 응답에서 확인할 수 있습니다.
temppersistent요청 예시
# 비동기 태스크 제출. 성공 시 즉시 taskId 반환(생성 완료 대기 없음)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "bria-eraser",
"input": {
"mask_url": "…",
"image_url": "…",
"mask_type": "manual",
"preserve_alpha": false
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "bria-eraser",
input: {
"mask_url": "…",
"image_url": "…",
"mask_type": "manual",
"preserve_alpha": false
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "bria-eraser",
"input": {
"mask_url": "…",
"image_url": "…",
"mask_type": "manual",
"preserve_alpha": False
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} 작업 상세 조회
https://api.hiapi.ai/v1/tasks/:id 응답 필드
taskIdstring필수태스크 ID. 접두사는 항상 tk-hiapi-.
modelstring필수확인된 전체 모델명. route 파라미터로 제출한 태스크는 base@route(예: gpt-image-2/text-to-image@ext)를 반환하며, 그 외에는 제출 시의 모델명과 동일합니다.
routestring선택route 파라미터를 명시해 제출한 태스크에만 나타나며, 제출한 값을 그대로 반환합니다.
statusstring필수태스크 상태.
queued 대기 중, 아직 시작되지 않음.
handling 처리 중.
archiving 처리 완료, 산출물 준비 중.
success 종료: 완료. 산출물 사용 가능(output 반환).
fail 종료: 실패(error 반환).
제출 후 status로 판단합니다: success와 fail이 종료 상태이며 나머지는 비종료입니다. 1~3초 간격으로 종료까지 폴링하세요. 성공 시 output[].url에서 산출물을 다운로드하고 expireAt 전에 옮기세요. 장기 보관이 필요하면 생성 시 storage: "persistent"를 사용하세요.
creatednumber필수태스크 생성 시각(Unix 초).
completednumber필수종료 상태가 된 Unix 초. 비종료 상태에서는 0.
outputarray선택
status == success일 때만 나타납니다. 산출물 목록 — 항상 배열이며, 하나의 태스크에서 여러 type을 동시에 반환할 수 있습니다(예: video + first_frame).
Array [ object ]
배열 항목
urlstring필수산출물 URL. 바로 다운로드할 수 있습니다.
typestring필수현재 가능한 값: video, image, audio, first_frame, last_frame, thumbnail. 이후 확장될 수 있습니다.
expireAtnumber필수산출물 접근 가능 기한(Unix 초). 만료 전에 다운로드하거나 이전하세요.
errorobject선택
status == fail일 때만 나타납니다.
codestring필수비즈니스 오류 코드.
messagestring필수오류 설명.
응답 예시
성공
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} 처리 중(비종료)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} 실패
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} 아티클
모든 아티클 보기 →-
비교 평가
Recraft v4.1 Flash 텍스트 투 이미지 횡적 비교: 개발자 선정 및 마이그레이션 가이드
이미지당 $0.01의 비용과 순수 텍스트 투 이미지 기능으로 귀하의 이미지 생성 파이프라인에 적합한지 판단하세요
-
튜토리얼
HiAPI에서 kling-4.0/image-to-video를 호출하는 방법: curl, Python 및 폴링
-
튜토리얼
HiAPI API로 hailuo-2.3/text-to-video를 호출하는 방법: curl, Python 및 실행 가능한 요청 예시
-
튜토리얼
HiAPI에서 Kandinsky 6.0 Pro 텍스트-투-비디오 사용하기: curl 및 Python 튜토리얼
요청 우선 실전 데모: 프롬프트에서 비디오 클립까지의 호출 구성, 요청 제출, 완료 상태 폴링 및 결과 다운로드
-
튜토리얼
recraft-v4.1-flash 텍스트-이미지 생성 실전: 5가지 고부가가치 비즈니스 시나리오와 연동 핵심 포인트
장당 $0.01의 비용에서 출발해, 이미지 생성이 실제 비즈니스에서 어떻게 안착할지 계획하기
-
비교 평가
hailuo-2.3-fast/image-to-video横向对比:이미지 투 비디오 모델 선택 방법과 마이그레이션 핵심 포인트
-
튜토리얼
HiAPI API로 kling-4.0/text-to-video를 사용하는 방법: curl, Python 및 실행 가능한 요청 예제
개발자를 위한 실전 가이드: 영화적 프롬프트, 동기화 오디오, 비동기 폴링 및 출력 다운로드
-
튜토리얼
HiAPI API로 hailuo-2.3-fast/image-to-video 호출하는 방법: curl과 Python 실전
빠르고 저렴한 이미지-투-비디오 등급의 첫 실행 요청 — 모델 ID부터 MP4 다운로드까지
-
튜토리얼
HiAPI에서 kandinsky-6.0-pro/image-to-video 튜토리얼: curl + Python
HiAPI에서 사용 가능한 이미지-투-비디오 요청 보내기: 첫 프레임 업로드부터 비동기 폴링, 최종 다운로드까지
관련 모델
모든 모델 보기 →동일 유형
-
Nano Banana 2 Google $0.036 /이미지 -
FIBO 1.5 Bria $0.058 /이미지 -
Imagen 4 Google $0.030 /이미지 -
Qwen Image 2.1 Alibaba $0.020 /이미지 -
Ideogram V3 Character Ideogram $0.090 /이미지 -
FLUX.1 Kontext Max Black Forest Labs $0.071 /이미지 -
Qwen Image 2.0 Alibaba $0.042 /이미지 -
Ideogram V4.5 Ideogram $0.011 /이미지 -
Grok Imagine Quality xAI $0.070 /이미지 -
FLUX.1 Fill Pro Black Forest Labs $0.071 /이미지 -
Muse Image 1.0 Meta $0.015 per task -
Recraft Creative Upscale Recraft $0.357 /이미지