---
title: "OpenClaw에서 Seedream 사용하기 via RunAPI — 이미지 API 가이드"
url: "https://runapi.ai/ko/openclaw-seedream.md"
canonical: "https://runapi.ai/ko/openclaw-seedream"
locale: "ko"
model: "seedream"
---

# OpenClaw에서 Seedream 사용하기.

Seedream은 강력한 타이포그래피 렌더링과 최대 4K 출력을 갖춘 Bytedance의 이미지 생성 모델입니다. OpenClaw agent는 채팅에 사용하는 동일한 RunAPI key와 endpoint로 호출합니다 — 추가 skill이나 provider 계정이 필요 없습니다.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/task/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-4.5-text-to-image",
    "prompt": "A premium coffee bag on a marble countertop, warm morning light, bold serif text FRESH ROAST, 4K product photography"
  }'

```

### Response

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

```

## How it works

1. **RunAPI 설정** — 이미 OpenClaw에서 채팅용 RunAPI를 설정했다면 완료입니다. 동일한 RUNAPI_API_KEY와 /v1 endpoint가 이미지 생성을 처리합니다. 그렇지 않다면 OpenClaw 가이드의 설정 프롬프트를 붙여넣거나 쉘에서 key를 내보내세요.
2. **Seedream 호출** — model을 seedream-4.5-text-to-image로 설정하여 text_to_image endpoint에 요청을 보내세요. 이미지를 설명하는 텍스트 프롬프트를 포함하세요. RunAPI는 즉시 task ID를 반환합니다.
3. **결과 가져오기** — 반환된 task ID로 task status endpoint를 폴링하세요. status가 completed로 변경되면, 응답에 생성된 이미지 URL이 포함됩니다. RunAPI SDK는 폴링을 자동으로 처리합니다.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 필수. seedream-4.5-text-to-image, seedream-4.5-edit, seedream-5-lite-text-to-image. |
| `prompt` | `string` | 원하는 이미지에 대한 텍스트 설명. |
| `size` | `string` | 선택 사항. 출력 크기. 최대 4K를 지원합니다. |
| `image_url` | `string` | 편집 모드를 위한 소스 이미지. |

## FAQ

### OpenClaw에서 Seedream을 사용할 수 있나요?

네. OpenClaw에서 RunAPI를 OpenAI 호환 provider로 설정한 뒤, model을 seedream-4.5-text-to-image로 설정하여 text_to_image endpoint를 호출하세요. 동일한 API key로 채팅과 이미지 생성이 모두 가능합니다.

### Seedream에 별도의 API key가 필요한가요?

아니요. 채팅에 설정한 동일한 RUNAPI_API_KEY로 Seedream과 RunAPI 카탈로그의 다른 모든 이미지 모델을 호출할 수 있습니다. 하나의 key, 하나의 결제 계정입니다.

### Seedream은 비동기인가요, 동기인가요?

비동기입니다. RunAPI는 첫 번째 호출 시 즉시 task ID를 반환합니다. status가 completed가 될 때까지 task status endpoint를 폴링한 뒤, 응답에서 이미지 URL을 가져오세요. SDK와 CLI는 폴링을 자동으로 처리합니다.

### Seedream 비용은 얼마인가요?

Seedream은 생성당 가격으로 청구됩니다. 현재 요금은 RunAPI 가격 페이지에서 확인하세요. 실패한 생성에는 요금이 부과되지 않습니다.


## Links

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