---
title: "OpenClaw에서 RunAPI로 Ideogram V3 사용하기 — 이미지 API 가이드"
url: "https://runapi.ai/ko/openclaw-ideogram-v3.md"
canonical: "https://runapi.ai/ko/openclaw-ideogram-v3"
locale: "ko"
model: "ideogram-v3"
---

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

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

## API example

```bash
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"
  }'

```

### Response

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

```

## How it works

1. **RunAPI 설정** — 쉘 프로필에 RUNAPI_API_KEY 환경 변수를 설정하세요. RunAPI가 이미 OpenClaw에서 채팅용으로 설정되어 있다면, 동일한 key가 Ideogram V3에도 작동합니다 — 추가 설정이 필요 없습니다.
2. **Ideogram V3 호출** — model을 ideogram-v3-text-to-image로 설정하여 text_to_image 엔드포인트에 POST 요청을 보내세요. 이미지에 렌더링하고 싶은 텍스트를 포함한 프롬프트를 작성하세요. 포스터와 로고 작업에는 style을 design으로, 사진 출력에는 realistic으로 설정하세요. 낮은 비용으로 빠른 결과를 얻으려면 rendering_speed turbo를 사용하세요.
3. **결과 가져오기** — API는 즉시 task_id를 반환합니다. 상태가 completed로 변경될 때까지 작업 상태 엔드포인트를 폴링한 후 응답에서 출력 이미지 URL을 가져오세요. output_count로 한 번의 호출당 최대 4개의 이미지를 요청하세요.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `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. |

## FAQ

### 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는 폴링을 자동으로 처리합니다. 실패한 생성은 청구되지 않습니다.


## Links

- [OpenClaw 설정 가이드 →](https://runapi.ai/ko/openclaw)
- [Ideogram V3 모델 →](https://runapi.ai/ko/models/ideogram-v3)
- [Model catalog](https://runapi.ai/ko/models)
- [API docs](https://runapi.ai/ko/docs)