
Ideogram 4.6 API를 사용하면 Ideogram의 최신 이미지 모델을 PoYo의 REST 엔드포인트 하나로 호출할 수 있습니다. 텍스트로 이미지를 생성할 때는 ideogram-v4.6, 소스 이미지 한 장을 편집할 때는 ideogram-v4.6-edit를 사용하며, 편집에는 마스크와 참조 이미지를 선택적으로 지정할 수 있습니다. 출력은 한 변 최대 4096픽셀이고, 가격은 이미지당 1.6 credits($0.008)부터 시작하며, 모든 요청은 PoYo의 다른 모델과 같은 API 키를 사용합니다. 이 글에서는 Ideogram 4.6이 무엇인지, 정확한 제한, 가격 티어, 그리고 출시일에 측정한 결과를 다룹니다.
Ideogram 4.6이란?
Ideogram 4.6은 Ideogram이 2026년 11월 19일에 출시한 이미지 생성 및 편집 모델입니다. Ideogram은 이 모델을 "지금까지 가장 정밀한 편집 모델"이라고 부르며, "네이티브 4K로 이미지를 생성"하고 "업스케일링이 없다"고 설명합니다. Ideogram은 모델 페이지에서 이 모델이 "편집 영역 바깥의 픽셀 드리프트를 훨씬 적게 남기고 색상을 더 정확하게 유지한다"고도 밝혔습니다.
Ideogram은 이를 high 품질에서의 작업별 점수로 뒷받침하며, 4.6과 4.5를 비교합니다.
| 작업(Ideogram의 설명) | Ideogram 4.6 | Ideogram 4.5 |
|---|---|---|
| 정확한 색상: 객체를 브랜드 HEX 코드로 다시 칠하기 | 83% | 46% |
| 제품 디테일: 제품 사진의 작은 결함 복구 | 86% | 61% |
| 제품 촬영: 제품 연출, 스타일 변경, 라벨 교체 | 88% | 66% |
| 캐릭터 일관성: 새로운 장면에서도 인물을 알아볼 수 있게 유지 | 85% | 69% |
| 마스크 편집: 칠한 영역만 변경 | 90% | 82% |
이 수치는 Ideogram이 발표한 것으로, PoYo가 측정한 값이 아닙니다. API 연동 관점에서는 다음 세 가지 요청을 이 모델로 보낼 가치가 있습니다.
- 정확한 문구가 들어간 포스터, 라벨, 소셜 그래픽: 프롬프트에서 텍스트를 따옴표로 감쌉니다.
- 나머지는 그대로 두어야 하는 편집: 전단지의 날짜 변경, 제품 색상 변경, 디테일 하나 수정 등.
- 대형 인쇄물: 별도 업스케일링 단계 없이 한 변 최대 4096픽셀의 사용자 지정 크기.
Ideogram 4.6 API 한눈에 보기
| 텍스트-이미지 | 편집 | |
|---|---|---|
| PoYo 모델 ID | ideogram-v4.6 | ideogram-v4.6-edit |
| 제출 엔드포인트 | POST https://api.poyo.ai/api/generate/submit | 동일 |
| 결과 | GET /api/generate/status/{task_id} 폴링 또는 callback_url 사용 | 동일 |
| 입력 | prompt | prompt + image_urls에 정확히 이미지 한 장, 선택적으로 mask_url과 reference_image_urls |
| 요청당 이미지 수 | 1~8(n) | 1~8(n) |
| 품질 단계 | very_low, low, medium(기본값), high | 동일 |
| Ideogram 출시일 | 2026년 11월 19일 | 2026년 11월 19일 |
| 문서 | Ideogram V4.6 API 레퍼런스 | Ideogram V4.6 Edit 레퍼런스 |
두 ID는 인증, 폴링, 과금을 공유하므로, 앱은 별도의 연동 없이 하나로 생성하고 다른 하나로 다듬을 수 있습니다.
제한 및 요청 필드
| 필드 | PoYo의 규칙 |
|---|---|
prompt | 필수, 1~10,000자, 공백이 아닌 텍스트를 포함해야 합니다. 이미지에 들어갈 정확한 텍스트는 따옴표로 감쌉니다. |
size | auto(기본값), 1:1(512×512), 1:1 HD(1024×1024), 4:3, 3:4, 16:9, 9:16 또는 사용자 지정 WIDTHxHEIGHT |
| 사용자 지정 크기 | 소문자 x, 두 변 모두 256 |
quality | very_low, low, medium(기본값), high. very_low는 4,194,304픽셀까지만 |
n | 1~8의 정수 |
background | transparent 또는 opaque. 텍스트-이미지와 일반 편집에서만 |
seed | 0~2,147,483,647의 정수 |
image_urls(편집) | 소스 이미지는 정확히 한 장, 공개 HTTP(S) URL 또는 base64 data URI, 항상 배열 |
mask_url(편집) | 소스와 같은 크기. 검은색은 편집, 흰색은 유지. size: auto 필요 |
reference_image_urls(편집) | 0~4장, 마스크 사용 시 최대 3장 |
edit_precision(편집) | regular(기본값) 또는 high. high는 size: auto가 필요하며 background를 거부 |
context_window(편집) | none(기본값) 또는 auto. auto는 mask_url과 edit_precision: high 필요 |
input 안의 그 밖의 필드는 unsupported fields 오류로 거부됩니다. 생성된 파일은 3일 동안 보관되므로 자체 스토리지로 복사해 두십시오.
Ideogram 4.6 API 가격
PoYo는 출력 이미지 한 장마다 품질과 크기 티어에 따라 과금합니다. "2K"는 최대 4,194,304픽셀(면적 기준 2048×2048)까지의 출력을 뜻하며, 그보다 크면 모두 "4K"입니다. 1 credit = $0.005입니다.
| 품질 | 텍스트-이미지 2K | 텍스트-이미지 4K | 편집 2K | 편집 4K |
|---|---|---|---|---|
very_low | 1.6 credits ($0.008) | 사용 불가 | 1.6 credits ($0.008) | 사용 불가 |
low | 6 credits ($0.03) | 12 credits ($0.06) | 6 credits ($0.03) | 12 credits ($0.06) |
medium | 12 credits ($0.06) | 24 credits ($0.12) | 12 credits ($0.06) | 40 credits ($0.20) |
high | 20 credits ($0.10) | 40 credits ($0.20) | 44 credits ($0.22) | 120 credits ($0.60) |
텍스트-이미지에서 size: auto와 6개 프리셋은 항상 2K입니다. size: auto로 편집하면 출력이 소스의 크기를 유지하므로, 큰 소스는 4K 티어로 과금됩니다. 이 가격은 Ideogram 모델 페이지의 이미지당 가격표와 일치합니다. 가격 상세 분석에서 실제 요청 형태로 계산 예시를 확인할 수 있습니다.
출시일에 측정한 결과
PoYo 팀은 2026년 11월 20일 PoYo 프로덕션 API에서 다음 작업을 실행했습니다. 프롬프트는 스크린 인쇄 스타일의 "NORTHBOUND JAZZ FESTIVAL" 포스터로, "JUNE 12-14 · RIVERSIDE PARK"와 "Three nights. Twenty-one bands. Free entry before 6 PM." 문구가 들어갑니다.
| 작업 | 요청 | 출력 | 과금 |
|---|---|---|---|
M4WA9OIQXVV80DHG | ideogram-v4.6, quality: high, size: 2304x3072, n: 1 | 2304×3072 PNG 한 장, 약 10.8 MB | 40 credits ($0.20) |
BS7M64COKT80JSLX | 같은 프롬프트, quality: very_low, size: 3:4 | 768×1024 PNG | 1.6 credits ($0.008) |
672JRU198S22NS8D | 첫 번째 포스터에 ideogram-v4.6-edit, edit_precision: high, context_window: none, size: auto, quality: high | 2304×3072 PNG | 120 credits ($0.60) |
처음 두 포스터에서는 작은 이탤릭체 줄을 포함해 모든 텍스트가 입력한 그대로 렌더링되었고, 드래프트는 구도가 달랐습니다. 편집 프롬프트는 Change only the date line to "JULY 3-5 · RIVERSIDE PARK". Keep everything else exactly the same.였습니다. 원본과 픽셀 차이를 비교한 결과, 변경된 픽셀은 모두 (471, 2699)에서 (1826, 2756)까지의 박스 하나, 즉 이미지의 약 1.1% 안에 있었고 나머지는 변하지 않았습니다. 고정밀 편집은 소스 해상도를 유지하기 때문에 이 편집은 4K high 티어로 과금되었습니다. 이 요청은 텍스트 및 정밀 편집 가이드에서 자세히 설명합니다.
첫 Ideogram 4.6 API 요청
curl https://api.poyo.ai/api/generate/submit \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "ideogram-v4.6",
"input": {
"prompt": "A minimalist poster titled \"SUMMER JAZZ NIGHTS\", bold typography",
"size": "2048x3072",
"quality": "high",
"n": 2
}
}'
2048x3072는 6,291,456픽셀이므로 이 요청은 4K high 요금으로 과금됩니다: 2 × 40 = 80 credits($0.40). 응답에는 data.task_id와 not_started 상태가 담깁니다. 상태가 finished가 될 때까지 상태 엔드포인트를 폴링한 뒤 data.files에서 이미지를 읽거나, 최상위에 callback_url을 전달합니다. 본문의 code는 항상 확인하십시오. 일부 검증 오류는 HTTP 200과 함께 code: 400을 반환합니다. API 가이드에는 제한 시간이 있는 Python 폴링 루프와 모든 입력 모드의 요청 본문이 있습니다.
Ideogram 4.6을 사용할 수 있는 곳
Ideogram은 자체 앱과 API에서 4.6을 제공하며, 엔드포인트는 Generate와 Precise Edit 두 가지입니다. PoYo에서는 다른 모든 모델에 쓰는 키와 동일한 작업 및 콜백 흐름으로 호출할 수 있고, 모델 페이지의 Playground는 실행할 때마다 가격을 먼저 보여 줍니다. PoYo에서 참조 이미지는 ideogram-v4.6-edit를 통해 전달합니다. 텍스트-이미지 ID는 프롬프트와 size, quality, n, background, seed 옵션만 받습니다.
요청별 라우팅
| 요청 | 모델 ID와 설정 |
|---|---|
| 초안과 레이아웃 탐색 | ideogram-v4.6, very_low 또는 low, 프리셋 크기, n 최대 8 |
| 면적 2048×2048 이하의 최종 포스터와 소셜 그래픽 | ideogram-v4.6, high, 1728x2304 같은 사용자 지정 크기 |
| 인쇄물과 대형 아트 | ideogram-v4.6, low~high, 4,194,304픽셀을 넘는 사용자 지정 크기 |
| 디테일 하나만 바꾸고 나머지 유지 | ideogram-v4.6-edit, edit_precision: high |
| 큰 이미지의 한 영역만 다시 그리기 | ideogram-v4.6-edit, mask_url, edit_precision: high, context_window: auto |
| 참조 이미지로 스타일 변경, 새 출력 크기 | ideogram-v4.6-edit, edit_precision: regular, reference_image_urls, 사용자 지정 size |
Ideogram 4.5에서 넘어오시나요? 4.6 vs 4.5 비교에서 필드 변경 사항, 새로운 크기 규칙, 같은 요청 기준의 가격을 정리했습니다. PoYo의 다른 이미지 API와 비교하려면 MAI Image 2.7 API 개요와 Kling Image 4.0 vs GPT Image 2.6 vs Seedream 5.5 비교를 참고하십시오.
자주 묻는 질문
Ideogram 4.6 API의 모델 ID는 무엇입니까?
텍스트-이미지에는 ideogram-v4.6, 편집에는 ideogram-v4.6-edit를 사용합니다. ideogram-4-6은 PoYo 페이지 슬러그일 뿐 모델 ID가 아닙니다.
Ideogram 4.6 API의 가격은 얼마입니까?
very_low 2K 기준 이미지당 1.6 credits($0.008)부터입니다. 기본값인 medium 2K 이미지는 12 credits($0.06), high는 2K에서 20 credits($0.10), 4K에서 40 credits($0.20)입니다. 고품질 4K 편집은 120 credits($0.60)입니다.
Ideogram 4.6 API가 반환할 수 있는 가장 큰 이미지는 무엇입니까? 사용자 지정 크기는 한 변 최대 4096픽셀, 32의 배수이며 종횡비는 1:6~6:1입니다. 4,194,304픽셀을 넘는 출력은 모두 4K 티어로 과금됩니다.
Ideogram 4.6 API는 이미지에 텍스트를 렌더링합니까? 예. 프롬프트에서 정확한 문구를 따옴표로 감싸십시오. 출시일 테스트에서 2304×3072 포스터는 제목, 날짜 줄, 작은 이탤릭체 줄을 입력한 그대로 렌더링했습니다. 그래도 Ideogram은 최종 결과에서 철자와 위치를 확인하라고 권장합니다.
Ideogram 4.6 API는 투명 이미지를 반환할 수 있습니까?
예. 텍스트-이미지 또는 일반 편집에서 background를 transparent로 설정합니다. 고정밀 편집은 background를 거부합니다.
Ideogram 4.6 API는 OpenAI SDK와 호환됩니까?
아니요. 비동기 작업 API입니다. /api/generate/submit에 제출한 뒤 /api/generate/status/{task_id}를 폴링하거나 콜백을 받습니다.