how-tos

Ideogram 4.6 API로 이미지 속 텍스트 렌더링과 고정밀 편집하기

Poyo.ai Team
6 min read
Share:

Ideogram 4.6 API의 이미지 속 텍스트와 고정밀 편집

Ideogram 4.6 API는 대부분의 이미지 API가 잘 처리하지 못하는 워크플로를 위해 만들어졌습니다. 정확한 문구가 들어간 포스터를 생성한 다음, 나머지는 다시 그리지 않고 그 텍스트의 한 줄만 바꾸는 작업입니다. 이 가이드는 두 단계를 요청 본문과 함께 다룹니다. ideogram-v4.6로 이미지 속 텍스트를 렌더링하고, ideogram-v4.6-edit로 고정밀 편집, 마스크 편집, 국소 편집을 합니다. 여기 나온 모든 내용은 PoYo의 Ideogram 4.6 모델에서 실행했으며, 수치는 2026년 11월 20일 출시일 테스트에서 나온 것입니다.

1부: Ideogram 4.6 API로 정확한 이미지 속 텍스트 렌더링하기

PoYo 문서는 텍스트에 대해 한 가지 규칙을 제시합니다. 이미지에 들어갈 정확한 텍스트는 프롬프트에서 따옴표로 감싸는 것입니다. 디자이너에게 브리핑하듯이 각 줄의 위치와 크기를 설명하십시오.

다음은 출시일 테스트(작업 M4WA9OIQXVV80DHG)의 요청입니다.

{
  "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
  }
}

약 10.8 MB의 2304×3072 PNG 한 장이 반환되었고, 4K high 요금인 40 credits($0.20)가 과금되었습니다. 따옴표로 감싼 세 줄은 작은 이탤릭체 줄을 포함해 모두 입력한 그대로 렌더링되었습니다. 같은 프롬프트를 quality: very_low, size: 3:4로 보낸 작업(BS7M64COKT80JSLX)은 768×1024 초안을 1.6 credits($0.008)에 반환했으며, 텍스트는 역시 정확했지만 구도는 달랐습니다.

프로덕션에서 텍스트 요청을 더 안정적으로 만드는 세 가지 습관이 있습니다.

습관이유
텍스트 한 줄마다 따옴표로 감싼 문자열 하나각 줄이 확인하고 나중에 편집할 수 있는 별도 단위가 됩니다
각 줄의 크기와 위치를 지정("상단에 큰 제목", "그 아래 작은 줄")위계를 요청에 포함시켜 우연에 맡기지 않습니다
게시 전에 출력 확인Ideogram도 "최종 결과에서 철자와 위치를 확인하십시오"라고 권장합니다.

이 API는 프롬프트 확장이 항상 켜져 있어 모델이 요청하지 않은 디테일을 추가할 수 있습니다. 이번 포스터에서는 하단 모서리에 작은 "EST. 1987"과 웹 주소가 추가되었습니다. 레이아웃에 입력한 문구만 들어가야 한다면 프롬프트에 그렇게 명시하고 결과를 확인하거나, 편집으로 추가 요소를 제거하십시오.

2부: ideogram-v4.6-edit로 편집하는 세 가지 방법

모든 편집은 image_urls에 정확히 한 장의 소스 이미지와 prompt를 받습니다. 아래 설정이 모델이 이미지의 어느 부분까지 손댈 수 있는지를 결정합니다. 앱에서 사용자가 소스를 업로드한다면 먼저 검사해 두면 실패하는 작업을 줄일 수 있습니다. 한 가지 방법은 이미지 모더레이션 가이드에서 소개합니다.

모드설정유지되는 것출력 크기
일반 편집edit_precision: regular(기본값)이미지가 프롬프트로부터 다시 생성됩니다auto 또는 마스크가 없을 때 임의의 프리셋/사용자 지정 크기
고정밀 편집edit_precision: high, context_window: none변경되지 않은 픽셀이 복원됩니다소스 해상도
국소 편집edit_precision: high, context_window: auto, mask_url마스크 주변 영역 바깥의 모든 픽셀소스 해상도

Ideogram은 4.6이 "편집 영역 바깥의 픽셀 드리프트를 훨씬 적게 남긴다"고 말하며, 모델 페이지에서 마스크 편집("칠한 영역만 변경") 점수를 Ideogram 4.5의 82% 대비 90%로 발표했습니다. 이는 Ideogram의 점수입니다. 아래는 저희가 측정한 결과입니다.

고정밀 편집: 텍스트 한 줄만 변경하기

{
  "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
  }
}

테스트(작업 672JRU198S22NS8D)에서 소스는 1부의 2304×3072 포스터였습니다. 출력은 새 날짜 줄이 들어간 2304×3072 이미지였습니다. 원본과 픽셀 차이를 비교한 결과, 변경된 픽셀은 모두 (471, 2699)부터 (1826, 2756)까지의 박스 하나, 즉 날짜 줄 안에 있었고 이미지의 약 1.1%였습니다. 제목, 일러스트, 작은 이탤릭체 줄은 변하지 않았습니다. 과금액은 120 credits($0.60)였는데, 고정밀 편집은 소스 해상도를 유지하고 2304×3072는 4,194,304픽셀을 넘기 때문입니다.

기억해야 할 규칙이 두 가지 있습니다. edit_precision: high는 size: auto(또는 size 생략)가 필요하고, background를 거부합니다.

마스크 편집: 변경을 한 영역으로 제한하기

마스크를 쓰면 편집이 어디에 적용될지 추측할 필요가 없습니다. 마스크는 소스와 크기가 같아야 하며, 모델이 편집할 수 있는 곳은 검은색, 유지해야 할 곳은 흰색으로 두 영역을 모두 포함해야 합니다. 다음 Python 코드는 박스로부터 마스크를 만듭니다.

from PIL import Image, ImageDraw

source = Image.open("poster.png")
mask = Image.new("L", source.size, 255)                       # white = keep
ImageDraw.Draw(mask).rectangle((440, 2660, 1860, 2800), fill=0)  # black = edit
mask.save("date-line-mask.png")

마스크를 업로드하고(공개 URL 또는 base64 data URI) 요청에 추가합니다.

{
  "model": "ideogram-v4.6-edit",
  "input": {
    "prompt": "Change the sign text to \"OPEN LATE\"",
    "image_urls": [
      "https://example.com/storefront.png"
    ],
    "mask_url": "https://example.com/sign-mask.png",
    "edit_precision": "high",
    "context_window": "auto",
    "quality": "high"
  }
}

context_window: auto를 쓰면 마스크 주변 영역만 편집되고 소스 해상도가 유지됩니다. 마스크가 너무 크면 이미지 전체 편집으로 대체됩니다. mask_url과 edit_precision: high가 둘 다 없는 context_window: auto는 거부되며, 마스크에는 항상 size: auto가 필요합니다. 마스크와 함께 로고나 폰트 샘플 같은 참조 이미지를 reference_image_urls에 최대 3장까지 추가할 수 있습니다.

3부: 파이프라인에서 편집 결과 검증하기

앱이 "텍스트만 바뀌었다"고 약속한다면 직접 확인하십시오. 다음은 출시일 편집에서 실행한 것과 같은 종류의 검사입니다.

from PIL import Image, ImageChops

before = Image.open("before.png").convert("RGB")
after = Image.open("after.png").convert("RGB")
assert before.size == after.size, "high-precision edits keep the source size"

diff = ImageChops.difference(before, after).convert("L").point(lambda v: 255 if v > 32 else 0)
box = diff.getbbox()
print("changed box:", box)
if box:
    area = (box[2] - box[0]) * (box[3] - box[1])
    print(f"box covers {area / (before.width * before.height):.2%} of the image")

이 박스를 바꾸려던 영역(예: 마스크)과 비교하십시오. 그보다 훨씬 넓게 퍼져 있다면 마스크와 context_window: auto를 쓰거나, 더 구체적인 프롬프트로 다시 시도하십시오.

4부: 여러 차례에 걸친 편집과 비용

연속으로 변경할 때는 각 결과를 다음 image_urls 소스로 다시 보내고, 요청마다 한 가지만 바꾸십시오. Ideogram 페이지는 4.6이 "여러 차례에 걸쳐 같은 이미지를 계속 다듬도록" 만들어졌다고 설명합니다. 각 차례는 별도의 작업이며 출력 크기에 따라 과금됩니다.

소스 편집…mediumhigh
4,194,304픽셀 이하12 credits ($0.06)44 credits ($0.22)
4,194,304픽셀 초과40 credits ($0.20)120 credits ($0.60)

4K 포스터에서 high 텍스트 변경을 세 번 하면 360 credits($1.80)이고, 같은 포스터의 1728×2304 버전이라면 132 credits($0.66)입니다. 생성된 파일은 3일 동안 보관되므로 각 결과를 다운로드하십시오. 가격 글에 더 많은 예산 예시가 있고, API 가이드에는 매 차례 재사용할 수 있는 폴링 루프가 있습니다.

자주 묻는 질문

Ideogram 4.6 API로 이미지에 정확한 텍스트를 넣으려면 어떻게 합니까? ideogram-v4.6 요청의 prompt에서 각 줄을 따옴표로 감싸고 크기와 위치를 설명합니다. 게시 전에 결과를 확인하십시오.

Ideogram 4.6 API로 기존 이미지의 텍스트를 바꾸려면 어떻게 합니까? Change only the date line to "NEW TEXT". Keep everything else exactly the same. 같은 프롬프트와 함께 이미지를 ideogram-v4.6-edit에 보냅니다. edit_precision: high와 size: auto를 설정하십시오.

edit_precision의 regular와 high는 어떻게 다릅니까? regular는 프롬프트로 이미지를 다시 생성하며 새 크기와 background를 지정할 수 있습니다. high는 정밀하게 편집하고, 변경되지 않은 픽셀을 복원하며, 소스 해상도를 유지합니다.

마스크가 Ideogram 4.6 API 가격을 바꿉니까? 아니요. 편집은 출력 이미지마다 품질과 크기 티어에 따라 과금됩니다. 마스크와 최대 3장의 참조 이미지는 포함되어 있습니다.

작은 텍스트 편집에 왜 120 credits가 과금되었습니까? 4,194,304픽셀을 넘는 소스를 high 품질로 고정밀 편집하면 4K high 편집 요금이 적용됩니다. 더 작은 소스를 편집하거나 medium(4K에서 40 credits, 2K에서 12 credits)을 사용하십시오.

전체 파라미터 목록은 Ideogram 4.6 Edit API 레퍼런스를 참고하십시오. 테스트를 거친 프롬프트 패턴은 Ideogram 4.6 API 프롬프트 가이드에서 확인하십시오.

Share: