
이 글은 Ideogram 4.6 API용 프롬프트 모음으로, 코드에 바로 붙여 넣을 수 있는 완전한 요청 본문 형태로 작성했습니다. ideogram-v4.6를 쓰는 텍스트-이미지 7개와 ideogram-v4.6-edit를 쓰는 편집 3개입니다. 각각 크기 티어와 가격을 함께 적어 두었으므로 보내기 전에 실행 비용을 알 수 있습니다. 모든 본문은 Ideogram 4.6의 PoYo 스키마를 따르며 POST https://api.poyo.ai/api/generate/submit로 보냅니다.
프롬프트 1은 2026년 11월 20일 출시일 테스트에서 사용한 요청 그대로입니다. 나머지는 실행하지 않은 템플릿이므로 출발점으로 삼고, 모든 출력을 확인하십시오.
Ideogram 4.6 API 프롬프트 작성법
스키마는 최대 10,000자를 허용하므로 구체적으로 쓸 여유가 있습니다. 타이포그래피에 잘 맞는 프롬프트는 보통 다섯 부분으로 구성됩니다.
| 구성 요소 | 예시 |
|---|---|
| 형식 | "스크린 인쇄 콘서트 포스터", "플랫 벡터 스티커", "제품 라벨" |
| 정확한 텍스트(따옴표로 감싸고 한 줄에 문자열 하나) | "NORTHBOUND JAZZ FESTIVAL" |
| 각 줄의 위계와 위치 | "상단에 크고 굵은 제목", "일러스트 아래에 작은 줄" |
| 시각 요소와 색상 | "해 질 녘 강 위의 업라이트 베이스와 색소폰, 틸, 번트 오렌지, 크림" |
| 마감 | "고운 종이 질감, 선명한 글자, 넉넉한 여백" |
프롬프트 확장이 항상 켜져 있으므로 모델이 디테일을 추가할 수 있습니다. 테스트 포스터에서는 모서리에 작은 "EST. 1987"과 웹 주소가 추가되었습니다. Ideogram의 자체 가이드는 "최종 결과에서 철자와 위치를 확인하라"는 것입니다.
설정은 습관이 아니라 단계에 따라 고르십시오. 레이아웃 초안에는 very_low(1.6 credits, $0.008), 기본값으로는 medium(12 credits, $0.06), 최종본에는 high를 사용합니다. 인쇄 크기가 필요하지 않다면 4,194,304픽셀 이하로 유지하십시오. 그 이상이면 모든 품질에서 가격이 두 배가 됩니다.
텍스트-이미지 프롬프트
1. 4K 이벤트 포스터(테스트 완료)
{
"model": "ideogram-v4.6",
"input": {
"prompt": "Screen-printed concert poster for \"NORTHBOUND JAZZ FESTIVAL\". Big bold condensed headline at the top, a stylized upright bass and saxophone silhouette over a river at dusk in deep teal, burnt orange and cream. Below the art, the line \"JUNE 12-14 · RIVERSIDE PARK\" and a smaller line \"Three nights. Twenty-one bands. Free entry before 6 PM.\" Fine paper grain, crisp letterforms, generous margins.",
"size": "2304x3072",
"quality": "high",
"n": 1
}
}
티어: 4K high, 40 credits($0.20). 측정 결과: 작업 M4WA9OIQXVV80DHG는 2304×3072 PNG를 반환했으며, 작은 이탤릭체 줄을 포함한 세 줄 모두 입력한 그대로 렌더링되었습니다. 같은 프롬프트를 초안용으로 "quality": "very_low"와 "size": "3:4"로 보내면 768×1024 이미지가 1.6 credits($0.008)에 반환되었고, 텍스트는 정확했지만 구도는 달랐습니다.
2. 요청 한 번으로 레이아웃 초안 만들기
{
"model": "ideogram-v4.6",
"input": {
"prompt": "Minimal bookstore event flyer with the headline \"AUTHOR NIGHT\" in large serif capitals, the line \"Thursday 7 PM · Upstairs\" below it, and a simple line drawing of an open book. Off-white paper, black and brick red.",
"size": "3:4",
"quality": "very_low",
"n": 8
}
}
티어: 2K very_low, 8 × 1.6 = 12.8 credits($0.064). 마음에 드는 레이아웃을 고른 뒤 더 큰 크기의 high로 다시 실행하십시오.
3. 제품 라벨
{
"model": "ideogram-v4.6",
"input": {
"prompt": "Front label for a small-batch hot sauce bottle, flat design, centered. Top line \"CASA FUEGO\" in a hand-painted script, middle line \"SMOKED HABANERO\" in bold sans-serif capitals, bottom line \"5 FL OZ · 148 ML\" in small type. Red, cream and charcoal, with a small chili illustration.",
"size": "1536x2048",
"quality": "medium"
}
}
티어: 2K medium(3,145,728픽셀), 12 credits($0.06).
4. 시드를 고정한 투명 스티커
{
"model": "ideogram-v4.6",
"input": {
"prompt": "A die-cut sticker of a cheerful cactus wearing sunglasses, with the words \"STAY SHARP\" on a curved banner underneath. Thick white outline, flat colors.",
"size": "1:1 HD",
"quality": "low",
"background": "transparent",
"seed": 42
}
}
티어: 2K low, 6 credits($0.03). transparent는 알파 채널이 있는 이미지를 반환합니다. 결과를 다시 얻으려면 같은 seed와 본문을 유지하십시오.
5. 4:5 소셜 인용 카드
{
"model": "ideogram-v4.6",
"input": {
"prompt": "Instagram quote card. Large centered quote \"Ship small. Ship often.\" in a modern grotesk typeface, and below it a small line \"— The Release Notes Podcast\". Solid sage green background with a thin cream border.",
"size": "1024x1280",
"quality": "medium",
"n": 4
}
}
티어: 2K medium, 4 × 12 = 48 credits($0.24). 1024x1280은 두 변이 모두 32의 배수인 정확한 4:5 크기입니다.
6. 16:9 동영상 썸네일
{
"model": "ideogram-v4.6",
"input": {
"prompt": "YouTube thumbnail, bold and high contrast. Left half: the text \"I BUILT A TINY CABIN\" in thick white capitals with a black outline, stacked on three lines. Right half: a small wooden cabin in a snowy forest at blue hour, warm light in the windows.",
"size": "2560x1440",
"quality": "high"
}
}
티어: 2K high(3,686,400픽셀), 20 credits($0.10). 이보다 큰 정확한 16:9 크기인 4096x2304는 40 credits입니다.
7. 간판이 있는 매장 장면
{
"model": "ideogram-v4.6",
"input": {
"prompt": "Photograph of a corner bakery at sunrise, wet cobblestones, a hand-painted wooden sign above the door reading \"MORNING CRUMB\", and a chalkboard by the door reading \"Fresh rye today\". Natural light, 35mm look.",
"size": "16:9",
"quality": "medium"
}
}
티어: 2K medium, 12 credits($0.06). 16:9 프리셋은 1024×576을 반환합니다. 같은 가격 티어에서 더 많은 디테일을 원하면 2048x1152 같은 사용자 지정 크기를 사용하십시오.
편집 프롬프트
편집은 image_urls에 정확히 이미지 한 장을 넣고 ideogram-v4.6-edit를 사용합니다. Ideogram 페이지는 문구 수정을 별도 단계로 나누라고 권하므로, 편집마다 한 가지 작업만 맡기고 무엇을 그대로 두어야 하는지 명시하십시오.
8. 텍스트 한 줄만 바꾸고 나머지는 유지하기
{
"model": "ideogram-v4.6-edit",
"input": {
"prompt": "Change only the date line to \"JULY 3-5 · RIVERSIDE PARK\". Keep everything else exactly the same.",
"image_urls": [
"https://example.com/northbound-poster.png"
],
"edit_precision": "high",
"context_window": "none",
"size": "auto",
"quality": "high",
"n": 1
}
}
티어: 소스 크기를 따릅니다. 측정 결과: 2304×3072 포스터(작업 672JRU198S22NS8D)에서 출력은 2304×3072를 유지했고, 변경된 픽셀은 모두 날짜 줄을 둘러싼 박스 하나, 즉 이미지의 약 1.1% 안에 있었으며, 과금액은 120 credits($0.60)였습니다. 4,194,304픽셀 이하의 소스라면 44 credits($0.22)입니다.
9. 제품을 브랜드 색상으로 다시 칠하기
{
"model": "ideogram-v4.6-edit",
"input": {
"prompt": "Recolor the ceramic mug to the exact brand blue #1E6FD9. Keep the mug's shape, handle, shadows, the table and the background exactly the same.",
"image_urls": [
"https://example.com/mug.png"
],
"edit_precision": "high",
"quality": "medium"
}
}
티어: medium 편집, 4,194,304픽셀 이하 소스는 12 credits($0.06), 그 이상은 40 credits입니다. Ideogram은 high 품질의 "정확한 색상" 작업에서 사용 가능한 결과 비율이 Ideogram 4.5의 46%에서 83%로 올랐다고 발표했습니다.
10. 참조 이미지를 바탕으로 소재 바꾸기
{
"model": "ideogram-v4.6-edit",
"input": {
"prompt": "Change the toy car's body to brushed copper like the reference image. Keep the scene, lighting and camera angle the same.",
"image_urls": [
"https://example.com/toy-car.png"
],
"reference_image_urls": [
"https://example.com/copper-swatch.png"
],
"quality": "low",
"n": 2
}
}
티어: low 일반 편집, 4,194,304픽셀 이하 출력에서 2 × 6 = 12 credits($0.06). 일반 편집은 이미지를 다시 생성하므로 background와 사용자 지정 size를 쓸 수 있습니다. 나머지를 픽셀 단위로 정확히 유지해야 한다면 edit_precision: high로 바꾸십시오.
프롬프트를 템플릿으로 만들기
대부분의 앱은 고정된 프롬프트 하나를 보내지 않고, 사용자의 이벤트 이름, 제품, 날짜 등으로 템플릿을 채웁니다. 따옴표로 감싼 문자열은 별도 변수로 유지하십시오. 그래야 요청을 보내기 전에 검증할 수 있고, 이후 편집(프롬프트 8)에서 정확한 문구로 특정 줄을 지정할 수 있습니다. 템플릿을 저렴하고 예측 가능하게 유지하는 몇 가지 규칙은 다음과 같습니다.
- 사용자 텍스트의 따옴표를 이스케이프합니다. 프롬프트는 JSON 문자열이므로 잘못 들어간
"하나가 본문을 망가뜨립니다. 문자열 연결 대신 JSON 라이브러리로 본문을 만드십시오. - 텍스트를 짧게 유지합니다. 작은 이미지 위의 긴 문장은 읽기도 어렵고 확인하기도 어렵습니다. 세부 문구는 별도의 크기 설명을 붙여 두 번째 줄로 옮기십시오.
- 형식별로 크기를 고정합니다. 출력 유형(포스터, 카드, 썸네일)마다 크기 하나를 저장하고 4,194,304픽셀 경계와 비교해, 사용자에게 보여 주는 가격과 청구액을 일치시키십시오.
- 작업 ID, 설정,
credits_amount를 기록합니다. 결과를 수정해야 할 때 무엇이 그 결과를 만들었는지 추측하지 않고 같은 본문을 다시 실행하거나 출력을 편집으로 보낼 수 있습니다. - 초안은
n으로, 마무리는 한 장으로.very_low초안 묶음은high2K 이미지 한 장보다 저렴하며, 선택한 레이아웃만 최종 렌더링으로 넘어갑니다.
프롬프트를 확장하기 전 체크리스트
| 확인 항목 | 이유 |
|---|---|
| 이미지 속 모든 문자열이 따옴표로 감싸져 있음 | 정확한 텍스트에 대한 문서의 규칙 |
| 사용자 지정 크기는 32의 배수, 한 변 256~4096 | 그 외는 거부됩니다 |
very_low는 4,194,304픽셀 이하에서만 사용 | 더 큰 크기에서는 거부됩니다 |
edit_precision: high와 마스크는 size: auto 사용 | 다른 크기는 거부됩니다 |
| 출력은 3일 이내에 다운로드 | 생성된 파일은 만료됩니다 |
Ideogram 4.6 API 가이드에는 이 본문들을 모두 실행할 수 있는 폴링 루프가 있고, 텍스트 및 정밀 편집 가이드는 프롬프트 8~10을 더 깊이 다룹니다.
자주 묻는 질문
Ideogram 4.6 API 프롬프트는 얼마나 길게 쓸 수 있습니까? 1~10,000자이며, 공백이 아닌 문자가 최소 하나 있어야 합니다.
Ideogram 4.6 API 이미지에 정확한 텍스트를 넣으려면 어떻게 합니까? 프롬프트에서 각 줄을 따옴표로 감싸고 위치를 설명하십시오. 프롬프트 확장으로 작은 추가 디테일이 생길 수 있으므로 출력을 확인하십시오.
Ideogram 4.6 API 프롬프트 하나로 여러 변형을 얻을 수 있습니까?
예. n을 1~8로 설정하십시오. 각 이미지는 티어 가격으로 과금됩니다.
Ideogram 4.6 API 결과를 다시 얻으려면 어떻게 합니까?
같은 본문을 같은 seed(0~2,147,483,647의 정수)로 보내십시오.
Ideogram 4.6 API 초안에는 어떤 품질을 써야 합니까?
very_low로, 4,194,304픽셀 이하 크기에서 이미지당 1.6 credits($0.008)입니다. 테스트 초안은 768×1024에서 포스터 텍스트를 정확하게 렌더링했습니다.