소개
image_url을 제출해 사진 1장에서 투명 PNG를 얻습니다. 이 작업에는 prompt, mask 또는 quality 필드가 공개되어 있지 않습니다.
| 항목 | 값 |
|---|---|
| 입력 | 이미지 |
| 출력 | 이미지 |
| 모델 ID | ideogram/remove-background |
| 요청당 입력 | 사진 1장 |
| 공개 파라미터 |
|
| 텍스트 지시 | prompt 파라미터 없음 |
| 사진당 출력 | 잘라낸 이미지 1장 |
| 파일 형식 | PNG |
| 배경 처리 | 투명 |
| 과금 단위 | 완료 이미지당 고정 요금 |
| 실패한 요청 | 과금 없음 |
| 결과 보관 | 14일 뒤 삭제 |
핵심 기능 및 하이라이트
벨뿐 아니라 레버도 확인
황동 자전거 벨 테스트는 작업대에서 부품을 분리했습니다. 투명 PNG는 레버·클램프 경계를 유지해 점검할 작은 윤곽의 구체적 예시가 됩니다. 해당 결과를 이해한 뒤 직접 제품 사진의 같은 부분을 보고 카탈로그를 만듭니다.
URL 하나로 시작
글 지시나 마스크 없이 image_url을 제출합니다. 완료 사진은 고정 이미지당 요금으로 투명 PNG를 반환합니다. 수영장 표지는 이 전환의 일러스트이며 실제 샘플이 아닙니다. 실측은 벨·빨간 새틴 예시를 봅니다.
경계가 깔끔한 빨간 새틴 인물
끈 없는 빨간 새틴 드레스의 스튜디오 사진은 투명 PNG로 반환됐습니다. 머리카락과 옷단 경계가 깔끔했습니다. 예시와 직접 결과를 대비 배경에서 확인합니다. 해당 사진의 근거이며 모든 머리 모양·옷·장소의 약속은 아닙니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
image_url | 예 | 배경을 제거할 원본 사진 URL을 제공합니다. 이 필수 입력에는 기본값이 없으며 완료된 사진마다 동일한 고정 이미지 단가를 적용합니다. 1자 이상 |
요금
$0.012 / 장
Ideogram 배경 제거는 완료된 추출 이미지에 고정 요금을 부과하며 처리에 실패하면 과금하지 않습니다.
활용 사례
하드웨어 카탈로그 배치
제품 사진을 카탈로그 구도용으로 준비합니다. 황동 자전거 벨은 유사 소품에서 점검할 레버·클램프 가장자리를 유지한 예시입니다.
패션 인물 레이아웃
촬영 의상과 착용자를 스튜디오 배경에서 분리합니다. 빨간 새틴 결과는 배치 전에 볼 머리카락·옷단 경계가 깔끔했습니다.
프로필·연사 그래픽
허용된 성인 인물의 투명 사진을 레이어로 쓰고 디자인 편집기에서 이름과 배경을 추가합니다.
캠페인 배경 변형
받은 PNG를 여러 캠페인 색·이미지 위에 재사용합니다. 배경은 배치 단계에서 넣으며 완성 구도와 투명 자산을 함께 보관합니다.
프롬프트 가이드 및 실전 팁
원본 사진 선택
별도 자산으로 필요한 대상이 있는 사진을 고릅니다. 인물은 사용이 허용된 성인 사진을 고르며 다른 사람을 사칭하지 않습니다.
이미지 URL 제출
image_url로 사진을 제공합니다. 다른 곳에서 원본을 준비할 때 글 구상을 쓸 수 있지만 이 엔드포인트에는 프롬프트·마스크를 보내지 않습니다.
반환 PNG 확인
편집기의 밝고 어두운 배경에서 머리카락, 옷단, 작은 부품의 윤곽을 본 뒤 배치합니다.
잘라낸 이미지 저장·배치
14일 안에 PNG를 저장합니다. 별도 구도 작업에서 배경을 추가하고 재사용할 투명 사본을 남깁니다.
사진을 재사용할 잘라낸 자산으로
Ideogram Remove Background는 사진 대상을 주변에서 분리해 투명 PNG 한 장을 반환합니다. 이미 있는 사진을 카탈로그·인물 배치·캠페인 자산으로 쓸 때 image-edit를 사용합니다. image_url만 제공하며 해석할 글 지시는 없습니다.
원본이 잘라낼 수 있는 대상을 정합니다. 다른 곳에 배치할 인물·제품이 있는 사진을 고르고 제출 전 윤곽을 확인합니다. 사용이 허용된 성인 사진을 고르며 다른 사람을 사칭하지 않습니다.
요청 파라미터
| 파라미터 | 필수 입력 | 역할 |
|---|---|---|
image_url | 원본 사진 1장의 URL | 배경 제거 사진 제공 |
공개 항목에는 prompt·마스크·품질·출력 형식·해상도 선택기가 없습니다. 생성 예시의 설정을 가져와 조절하려 하지 않습니다. 결과가 투명 PNG로 정의돼 있어 문장으로 투명을 요청할 필요가 없습니다.
빨간 새틴 예시는 image_url에 스튜디오 원본을 넣었습니다. 옷·머리 모양·배경은 텍스트로 설명하지 않았으며 이미 사진 안에 있었습니다.
요금과 저장
완료 배경 제거 이미지당 고정 요금이며 실패는 무료입니다. 다른 도구나 구독 가격을 이 엔드포인트의 요금으로 보지 말고 Ideogram Remove Background 모델 페이지의 현재 금액을 확인합니다.
PNG를 14일 안에 받습니다. 이후 삭제되므로 원본과 함께 저장해 후속 배치가 호스팅 파일에 의존하지 않도록 합니다.
원본 사진 구상 활용
제거 요청에는 프롬프트가 없습니다. 페이지의 예시는 다른 곳에서 원본을 선택·촬영·준비할 구상으로, 옷·분위기·빛·장소를 설명합니다. 준비된 이미지 URL을 보냅니다.
새틴 이브닝드레스의 30대 여성이라는 구상은 스튜디오 촬영을 안내하지만 제거 요청에 넣어도 지원 제어가 되지 않습니다. 제품도 촬영 전에 황동 마감·시점·부드러운 작업실 빛을 정할 수 있습니다.
입력 준비 시 다음을 확인합니다.
- 구도에 필요한 부분이 사진 안에 보이게 합니다.
- 인물·제품·특정 이름의 사물 중 필요한 대상을 정한 뒤 작업을 고릅니다.
- 인물 사진 사용 허가와 성인 여부를 확인합니다.
- 세부 비교용 원본을 남깁니다.
실제 예시 결과
황동 자전거 벨
작업대 배경에서 벨이 깔끔히 분리됐고 레버·클램프 경계가 남았습니다. 큰 벨 형태만 보지 말고 작은 부분도 원본과 대조합니다.
빨간 새틴 스튜디오 인물
끈 없는 드레스의 여성 사진은 머리카락·옷단 경계가 깔끔한 투명 PNG가 됐습니다. 해당 사진의 관찰이며 모든 머리 모양·원단·배경의 결과를 입증하지 않습니다.
수영장 표지는 일러스트이며 생성 샘플이나 추가 실측이 아닙니다. 설명된 결과의 근거는 두 잘라내기 예시입니다.
배치 전 PNG 검토
투명 표시를 지원하는 편집기에서 다운로드 파일을 엽니다. 밝고 어두운 배경을 아래에 놓고 사용 규모에서 머리카락·옷단·좁은 부품 윤곽을 봅니다. 체크무늬는 표시 보조이므로 실제 PNG로 적합성을 판단합니다.
투명 결과에는 흰 배경이나 대체 장면이 없습니다. 구도 도구에서 배경을 추가하고 완성 내보내기와 투명 사본을 함께 둡니다. 같은 자산을 재사용하며 배경 교체를 이 엔드포인트의 제어로 취급하지 않습니다.
한계와 관련 선택지
요청은 사진 한 장에서 투명 PNG 한 장을 만듭니다. 특정 사물 이름이나 옷·빛·주변 변경을 지시할 공개 텍스트 필드는 없습니다. 결정이 반영된 원본을 고릅니다.
다른 배경 제거에는 Background Remover V1, 글로 지정한 사물 선택에는 Object Extractor V1을 사용합니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "ideogram/remove-background/edit",
"input": {
"image_url": "https://example.com/reference.png"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.





