소개
image_url로 원본을 제공하고 원하는 변경을 설명합니다. 검은 바탕의 흰 마스크로 편집 영역을 정하고 참조로 스타일이나 내용을 제공합니다. high 편집 정밀도는 변경 범위를 제한합니다.
| 항목 | 값 |
|---|---|
| 입력 | 이미지 |
| 출력 | 이미지 |
| 제작사 | Ideogram |
| 지원 작업 | 텍스트 이미지 생성, 이미지 편집 |
| 프롬프트 허용량 | 최대 10,000자, 나타낼 글자를 인용 |
| 생성 품질 단계 | low, medium(기본), high |
| 편집 품질 단계 |
|
| 해상도 | 1k 또는 2k, 크기에 따른 품질 단계 요금 차이 없음 |
| 화면비 선택지 | 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 |
| 편집 안내 | 선택 흑백 마스크, 흰색이 변경 영역 |
| 참조 허용량 | 스타일·내용 이미지 최대 4장, 마스크와 함께는 최대 3장 |
| 편집 정밀도 | regular 또는 high, high는 변경을 더 절제 |
| 청구 방식 | 품질별 이미지당 과금, 크기·비율·참조 수 무관, 실패 무료 |
| 파일 보관 기한 | 생성 파일은 14일 후 삭제 |
핵심 기능 및 하이라이트
보조 문구까지 유지한 AFTER DARK
새 포스터는 광택 빨간 제목과 새틴 드레스 여성 아래 One night only를 결합합니다. medium, 1k, 2:3에서 두 문자열이 정확했습니다. 인용 줄마다 위치를 주고 인물·네온빛·인쇄 질감을 설명합니다. 제공 텍스트 두 블록의 실측 사례이므로 직접 반환 문구도 확인합니다.
축제 정보 위의 여행지 이름
LUMEN BAY 테스트는 큰 여행지 제목과 작은 Summer Festival · July 12–14를 범선·줄무늬 등대의 해안 구도에서 선명히 유지했습니다. 그림 설명 전에 각 위치를 구분합니다. 품질이 요금을 고르며 1k·2k는 같은 단계 요금입니다.
온실 고양이가 쉴 자리 추가
온실 돌길에 나무 벤치와 자는 주황 고양이를 넣으며 주변 식물과 조명은 그대로였습니다. 추가물을 명시하고 나머지는 보존 목표로 둡니다. 영역 제한은 흰색 마스크를 쓰며 참조·high 정밀도도 테스트에서 적용됐지만 결과마다 시각 검토가 필요합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 요청할 수정을 최대 10,000자로 쓰고 추가할 글자는 따옴표로 묶습니다. 지시 내용에 따라 품질 기반 단가가 달라지지는 않습니다. 1자 이상 · 10000자 이하 |
image_url | 예 | 이 필드에 수정할 이미지를 제공합니다. 원본 이미지로 별도 요금이 더해지지 않습니다. 1자 이상 |
mask_url | 아니요 | 흰색으로 변경할 곳을 표시한 흑백 마스크를 선택적으로 제공합니다. 마스크 사용은 가격을 바꾸지 않습니다. 1자 이상 |
reference_image_urls | 아니요 | 내용이나 스타일 참조를 최대 4장, 마스크 사용 시 최대 3장 추가하고 Image 1 등의 번호로 지정합니다. 참조 수는 요금에 영향을 주지 않습니다. 4개 이하 |
aspect_ratio | 아니요 | 편집 캔버스를 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16으로 정합니다. 화면비 7종 모두 선택한 품질 단가를 사용합니다. |
quality | 아니요 | 편집은 |
resolution | 아니요 | 편집 결과는 1k 또는 2k로 선택하며 크기에 따른 가격 인상은 없습니다. |
edit_precision | 아니요 | regular 또는 high를 선택합니다. high는 수정을 더 절제하며 이 선택에 따른 추가 단가는 없습니다. |
요금
편집 요금은 품질을 따르며 더 저렴한 very_low 옵션도 있습니다. 이미지 크기, 화면비와 참조 수에는 추가 요금이 없고 실패한 편집은 청구하지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.0096 / 장 |
| $0.036 / 장 |
| $0.072 / 장 |
| $0.264 / 장 |
활용 사례
복고 영화·저녁 행사 포스터
인용 제목과 별도 행사 문구로 구도를 만듭니다. AFTER DARK는 medium, 1k, 2:3에서 새틴 드레스 인물과 복고 표현을 담고 두 줄을 정확히 썼습니다.
여행·축제 그림
일러스트 위에 여행지 이름, 아래에 행사 세부를 배치합니다. LUMEN BAY는 해안 그림과 함께 큰 제목과 작은 축제 문구를 선명히 유지했습니다.
기존 장면의 작은 추가
주변 장소·빛을 남기며 지정 사물을 넣습니다. 온실 편집은 나무 벤치와 자는 주황 고양이를 추가하고 나머지 장면을 유지했습니다.
참조 기반 디자인 수정
팔레트·소재·스타일·내용용 사진을 주고 역할을 설명합니다. 편집 참조는 4장, 마스크를 함께 주면 3장입니다.
구도의 특정 영역 제어
흑백 마스크에서 변경 영역을 흰색으로 표시하고 지시로 설명합니다. high 정밀도는 더 절제된 변경이며 테스트에서 마스크와 해당 제어가 적용됐습니다.
프롬프트 가이드 및 실전 팁
새 이미지 또는 편집 선택
글로 설명할 구도는 text-to-image에서 시작합니다. 기존 사진이 장면을 제공하면 image-to-image에 image_url로 넣습니다.
문구와 미술 지시 분리
제목과 보조 문구를 각각 인용하고 위치를 정합니다. 주변 장소, 의상, 빛, 그래픽 질감을 설명합니다.
품질과 캔버스 설정
이미지당 요금을 위한 품질을 고른 뒤 1k·2k와 지원 비율을 선택합니다. 기본 품질은 medium이며 편집은 very_low도 제공합니다.
변경 안내와 검토
편집에 선택 흰 영역 마스크와 역할별 번호 참조를 넣습니다. 글자와 보존 요소를 살피고 14일 보관 기간 전에 채택 파일을 받습니다.
제공 사진 수정
Ideogram 4.5 image-to-image는 image_url의 사진에 prompt의 수정을 적용합니다. 기존 장면의 사물 추가, 세부 변경, 시각 안내를 사용한 디자인에 적합합니다. 변경과 유지 요소를 모두 정합니다.
온실 테스트는 돌길에 나무 벤치와 자는 주황 고양이를 추가하며 식물·조명을 유지했습니다. 별도 테스트에서 마스크·참조·high 정밀도가 적용됐습니다. 제어 근거이며 모든 요청의 완벽한 보존을 입증하지 않습니다.
편집 파라미터
| 파라미터 | 값 또는 한도 | 역할 |
|---|---|---|
image_url | 원본 사진 | 편집 대상 |
| prompt | 최대 10,000자 | 변경, 보존, 인용 문구 |
mask_url | 선택 흑백 마스크 | 흰색이 변경 영역 |
reference_image_urls | 최대 4장, 마스크와는 3장 | Image 1 이후 스타일·내용 참조 |
edit_precision | regular, high | high는 더 절제된 변경 |
| quality | very_low, low, medium, high, 기본 medium | 이미지당 요금 |
| resolution | 1k, 2k | 출력 크기 |
aspect_ratio | 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 | 편집 캔버스 형태 |
품질은 요금, edit_precision은 변경의 절제 정도를 정합니다. high 정밀도와 high 품질은 다른 지시입니다.
원본 중심의 지시
변경과 보존 분리
벤치 추가, 라벨 다시 칠하기, 특정 항목 변경처럼 직접 시작하고 식물·탁자·빛·사물 형태 등 보존 요소를 잇습니다. 막연한 개선 요청에 원본의 중요 부분을 숨기지 않습니다.
온실에서는 벤치 위치와 자는 고양이를 정하고 주변을 보존합니다. 글자 추가는 정확한 문구를 인용하고 위치를 정합니다. 새 글자뿐 아니라 유지 요청한 기존 글자도 살펴봅니다.
마스크로 영역 지정
선택 흑백 마스크의 흰색이 편집 요청 영역입니다. 안에서 바꿀 것과 주변에서 유지할 것을 설명합니다. 테스트에서 작동했지만 매번 경계·주변 요소가 동일함을 뜻하지 않습니다.
mask_url 추가 시 참조 수를 다시 셉니다. 마스크 없이 4장, 있으면 3장입니다. image_url은 여전히 편집 원본이며 이 감소는 참조 목록에만 해당합니다.
참조별 역할
원본은 수정 대상을, 참조는 원하는 스타일·내용을 제공합니다. Image 1, Image 2 이후로 이름과 기여를 적습니다. 식물 팔레트는 제품 형태를 대체하지 않고 라벨을 안내할 수 있습니다.
여러 참조는 소재용과 색상용처럼 짧게 연결하고 마지막에 원본 보존 요소를 적습니다. 테스트는 참조 작동을 확인했지 모든 요소의 전송을 입증하지는 않습니다.
다음 편집 전 검토
새 사물, 유지 장면, 글자, 캔버스를 원본과 비교합니다. 벤치·고양이 주변 식물과 조명을 유지한 온실 결과는 개별 변경 예시이며 긴 연속 작업의 보장이 아닙니다.
채택 버전을 남기고 다음 지시를 구체화합니다. 후속 입력 전에 각 결과를 확인합니다. 인물은 사용 권한이 있는 성인 사진을 쓰고 누구도 사칭하지 않습니다.
요금 결정
이미지당 품질별 과금이며 편집에는 저렴한 very_low가 있습니다. 품질이 높으면 요금이 오르지만 크기·화면비·참조 수는 영향이 없고 정밀도 별도 요금도 없습니다. 실패 편집은 무료입니다.
Ideogram 4.5 모델 페이지의 현재 요금을 확인합니다. 용도에 맞게 1k·2k와 형태를 고르고 예산에 맞게 품질을 정합니다. 마스크·참조는 안내이지 새 과금 단위가 아닙니다.
제한과 관련 도구
Ideogram 필터가 표시한 요청은 과금 없이 거부합니다. 14일 후 삭제되므로 채택 출력을 미리 저장합니다.
새 장면 설명은 text-to-image, 사진 잘라내기는 Ideogram Remove Background, SVG는 Ideogram Vector 1을 사용합니다. 편집 지시가 파일 형식을 바꾼다고 가정하지 말고 입력·출력으로 선택합니다.
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/4.5/edit",
"input": {
"edit_precision": "regular",
"image_url": "https://example.com/reference.png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "medium",
"resolution": "1k"
}
}'
# 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 레퍼런스에서 확인하세요.







