소개
prompt에 디자인 문구를 따옴표로 묶어 구도를 설명합니다. 이미지 크기·화면비와 별도로 품질 단계를 선택하며 프롬프트 확장으로 짧은 설명을 구체화할 수 있습니다.
| 항목 | 값 |
|---|---|
| 입력 | 텍스트 |
| 출력 | 이미지 |
| 제작사 | 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자 이하 |
aspect_ratio | 아니요 | 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 중에서 구도를 정합니다. 화면비에 별도 요금은 없습니다. |
quality | 아니요 | 생성 품질은 low, medium(기본값), high 중에서 선택합니다. 상위 품질 단계일수록 이미지당 비용이 높습니다. |
resolution | 아니요 | 이미지 크기는 1k 또는 2k를 선택하며 품질 단계의 요금은 그대로입니다. |
enable_prompt_expansion | 아니요 | 이 옵션을 켜면 생성 전에 모델이 짧은 지시를 확장합니다. 과금 기준은 계속 품질입니다. 기본값: |
요금
생성 이미지는 선택한 품질 단계로 과금합니다. 해상도와 화면비는 해당 단가를 바꾸지 않으며 실패한 요청에는 요금을 부과하지 않습니다.
| 사양 | 요금 |
|---|---|
| $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 text-to-image는 설명에서 시작해 제공 글자를 사진 안에 배치할 수 있습니다. 새 포스터·일러스트 표지·행사 그래픽에 사용합니다. 인용 문구는 나타낼 단어, 미술 지시는 주변 그림을 설명합니다.
실측 LUMEN BAY는 여행지 제목과 작은 축제 문구를 선명히 결합했습니다. AFTER DARK는 광택 빨간 제목과 One night only, 새틴 드레스 여성을 복고 구도에 담았습니다. 특정 배치의 결과이며 모든 문구·배치를 약속하지 않습니다.
파라미터별 역할
| 파라미터 | 선택 또는 한도 | 사용법 |
|---|---|---|
| prompt | 최대 10,000자 | 구도 설명과 필수 글자 인용 |
| quality | low, medium, high, 기본 medium | 이미지당 요금 단계 |
| resolution | 1k, 2k | 단계 요금 변경 없이 크기 선택 |
aspect_ratio | 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 | 배치할 형태 선택 |
enable_prompt_expansion | 선택 확장 | 생성 전 짧은 지시 구체화 |
생성에는 편집용 very_low가 없습니다. 원본 사진이 필요한 요청은 마스크·참조·정밀도도 있는 image-to-image를 사용합니다.
품질별 요금
제공 이미지마다 품질로 과금합니다. low에서 medium·high로 올리면 요금이 오르고 1k·2k 전환이나 화면비 7가지는 요금을 바꾸지 않습니다. 글자 한도는 구상 공간이며 과금 단위가 아닙니다.
Ideogram 4.5 모델 페이지에서 현재 요금을 확인합니다. 실패한 작업에는 비용이 들지 않습니다. 품질은 요금, 캔버스는 크기·형태로 나눠 고릅니다.
레이아웃의 일부로 글자 작성
텍스트 블록 역할
장식 전에 문구를 정합니다. 제목, 보조 줄, 각 위치, 주변 장면 순서가 유용합니다. AFTER DARK 구조는 인물 위의 인용 제목과 아래 여백의 짧은 행사 문구입니다.
중요한 구두점까지 전체 문자열을 따옴표로 묶고 큰 줄과 작은 줄을 정해 위계를 줍니다. 사용 전 제목·보조 줄을 제공 문구와 대조합니다.
구체적인 장면 지시
인물이 있으면 대상·의상·장소·분위기·빛을 적습니다. 네온 영화관 밖 새틴 이브닝드레스의 30대 후반 여성과 역 플랫폼의 열린 옷깃 셔츠를 입은 40대 남성은 서로 다른 장면입니다. 제안 장면의 인물은 30대 이상입니다.
복고 포스터의 실크스크린 질감과 제한 팔레트처럼 구상에 맞는 그래픽 표현을 고릅니다. 위치 설명뿐 아니라 화면비도 설정합니다. 세로 포스터는 2:3, 가로는 지원 가로 비율을 씁니다.
짧은 시작 구상 확장
enable_prompt_expansion은 생성 전 짧은 지시를 확장하며 테스트에서 적용됐습니다. 의도한 문구는 직접 결정할 수 있으므로 확장 중에도 정확한 제목·행사 문구는 직접 적습니다.
테스트 결과
- LUMEN BAY 제목과 Summer Festival · July 12–14가 선명했습니다.
- medium, 1k, 2:3의 AFTER DARK는 제목과 One night only를 정확히 쓰고 새틴 드레스 인물이 뒤돌아보는 모습을 보였습니다.
- 프롬프트 확장이 적용됐으나 모든 지시의 개선을 입증하지는 않습니다.
작은 글자도 제목처럼 검토합니다. 예시는 표시 배치의 근거이며 다른 디자인·긴 글의 실측 성공률은 없습니다.
제한과 다음 작업
Ideogram 자체 심사로 차단된 요청은 무료 거부입니다. 파일은 14일 후 삭제되므로 선택 이미지, 프롬프트, 설정을 저장합니다.
기존 사진을 바꾸면 이 모델의 image-to-image, SVG는 Ideogram Vector 1, 사진 배경 제거는 Ideogram Remove Background를 고릅니다. 새 포스터와 입력·출력이 다릅니다.
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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "medium",
"resolution": "1k",
"aspect_ratio": "1:1"
}
}'
# 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 레퍼런스에서 확인하세요.






