Ideogram V3는 다른 모델에 비해 이미지 내 텍스트를 어떻게 처리하나요?

Ideogram V3는 타이포그래피 렌더링에 특화되어 있습니다. Flux나 Imagen 같은 모델이 자주 뭉개는 읽기 가능한 다줄 텍스트, 스타일화된 헤딩, 로고 품질의 레터링을 생성할 수 있습니다. 포스터, 간판, 제품 라벨에 정확한 텍스트가 필요한 경우 Ideogram V3가 RunAPI 카탈로그에서 가장 강력한 옵션입니다.

turbo, balanced, quality 렌더링 속도의 차이점은 무엇인가요?

Turbo는 balanced 비용의 약 절반으로 가장 빠르게 생성합니다. Quality는 가장 높은 디테일의 출력을 생성하지만 더 오래 걸립니다. Balanced는 기본값인 중간 지점입니다. 세 티어 모두 동일한 Ideogram V3 모델을 사용합니다 — 차이는 컴퓨팅 시간과 품질이지, 모델 버전이 아닙니다.

Ideogram V3로 기존 이미지를 편집하거나 리믹스할 수 있나요?

네. 텍스트 프롬프트로 가이드된 소스 이미지를 수정하려면 edit_image 엔드포인트에 ideogram-v3-edit를 사용하세요. 소스 이미지의 스타일을 새 구성으로 전이하려면 remix_image 엔드포인트에 ideogram-v3-remix를 사용하세요. 둘 다 파라미터로 source_image_url이 필요합니다.

output_count로 이미지당 가격은 어떻게 책정되나요?

생성된 각 이미지는 별도로 청구됩니다. output_count를 4로 설정하면 4개의 이미지에 대해 요금이 부과됩니다. 이미지당 요금은 rendering_speed 설정에 따라 다릅니다 — turbo는 balanced의 약 절반 비용입니다. 현재 요금은 RunAPI 가격 페이지를 확인하세요.

Ideogram V3는 비동기인가요, 동기인가요?

비동기입니다. API는 즉시 task_id를 반환합니다. 작업이 완료될 때까지 작업 상태 엔드포인트를 폴링하세요. RunAPI SDK와 CLI는 폴링을 자동으로 처리합니다. 실패한 생성은 청구되지 않습니다.

OPENCLAW + IDEOGRAM V3

OpenClaw에서 Ideogram V3를 사용하세요.

Ideogram V3는 업계 최고 수준의 텍스트 렌더링으로 이미지를 생성합니다 — 다른 이미지 모델이 어려워하는 포스터, 로고, 간판의 읽기 쉬운 타이포그래피. text_to_image, edit_image, remix_image 세 가지 엔드포인트와 생성 시간을 절반으로 줄이는 turbo 속도 티어를 제공합니다. OpenClaw 에이전트는 채팅에 사용하는 동일한 RunAPI key와 /v1 엔드포인트로 호출합니다 — 추가 스킬 설치가 필요 없습니다.

API Key 받기 문서 읽기

하나의 API key · 타이포그래피 우선 생성 · turbo 속도 티어

Use RunAPI to generate an image with accurate text rendering using Ideogram V3.

Requirements:
- Use the RunAPI API at https://runapi.ai/v1/text_to_image.
- Read the API key from RUNAPI_API_KEY environment variable.
- Set the model to "ideogram-v3-text-to-image".
- Write a prompt that includes specific text you want rendered in the image.
- Optionally set rendering_speed to turbo for faster generation, or quality for best results.
- The response returns a task_id. Poll the task status endpoint until the task completes, then retrieve the output URL.

curl -X POST https://runapi.ai/v1/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ideogram-v3-text-to-image",
    "prompt": "A minimalist cafe menu poster, cream background, the text FRESH BREWED written in elegant serif font at the top, three coffee cup illustrations below, warm earth tones",
    "style": "design",
    "aspect_ratio": "3:4",
    "rendering_speed": "balanced"
  }'

{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "ideogram-v3-text-to-image"
}

curl 명령어를 복사하여 테스트하세요 ideogram-v3

작동 방식

OpenClaw에서 Ideogram V3를 세 단계로 사용하기

RunAPI 설정

쉘 프로필에 RUNAPI_API_KEY 환경 변수를 설정하세요. RunAPI가 이미 OpenClaw에서 채팅용으로 설정되어 있다면, 동일한 key가 Ideogram V3에도 작동합니다 — 추가 설정이 필요 없습니다.

export RUNAPI_API_KEY=runapi_xxx

Ideogram V3 호출

model을 ideogram-v3-text-to-image로 설정하여 text_to_image 엔드포인트에 POST 요청을 보내세요. 이미지에 렌더링하고 싶은 텍스트를 포함한 프롬프트를 작성하세요. 포스터와 로고 작업에는 style을 design으로, 사진 출력에는 realistic으로 설정하세요. 낮은 비용으로 빠른 결과를 얻으려면 rendering_speed turbo를 사용하세요.

POST /v1/text_to_image

결과 가져오기

API는 즉시 task_id를 반환합니다. 상태가 completed로 변경될 때까지 작업 상태 엔드포인트를 폴링한 후 응답에서 출력 이미지 URL을 가져오세요. output_count로 한 번의 호출당 최대 4개의 이미지를 요청하세요.

task_id: tsk_abc123

파라미터

Ideogram V3 API 파라미터

파라미터	유형	설명
`model`	`string`	필수. ideogram-v3-text-to-image, ideogram-v3-edit, 또는 ideogram-v3-remix.
`prompt`	`string`	원하는 이미지의 텍스트 설명. 렌더링하고 싶은 특정 텍스트를 포함하세요.
`style`	`string`	선택 사항. auto, general, realistic, 또는 design. 포스터와 로고에는 design을 사용하세요.
`rendering_speed`	`string`	선택 사항. turbo (가장 빠름, 최저 비용), balanced (기본값), 또는 quality (최고 디테일).
`aspect_ratio`	`string`	선택 사항. 1:1, 3:4, 9:16, 4:3, 또는 16:9.
`output_count`	`integer`	선택 사항. 요청당 생성할 이미지 수. 1~4.
`source_image_url`	`string`	편집 및 리믹스 엔드포인트에 필수. 소스 이미지의 URL.

OpenClaw의 Ideogram V3이란?

Ideogram V3은 생성 이미지의 타이포그래피 분야에서 '게임 체인저'라 불리는 모델로, 1~2번의 시도로 90~95%의 텍스트 정확도를 달성하며 스타일 참조로 브랜드 일관성 유지를 지원합니다. OpenClaw agent는 채팅과 동일한 RunAPI 키로 호출합니다.