OpenClaw에서 Seedream 사용하기.
Seedream은 강력한 타이포그래피 렌더링과 최대 4K 출력을 갖춘 Bytedance의 이미지 생성 모델입니다. OpenClaw agent는 채팅에 사용하는 동일한 RunAPI key와 endpoint로 호출합니다 — 추가 skill이나 provider 계정이 필요 없습니다.
Generate a 4K product hero image using Seedream through RunAPI.
Requirements:
- Use the RunAPI text_to_image endpoint.
- Set model to seedream-4.5-text-to-image.
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Poll the task status endpoint until the task completes.
- Return the generated image URL from the task response.
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"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "seedream-4.5-text-to-image"
}
OpenClaw에서 Seedream을 세 단계로 사용하기
RunAPI 설정
이미 OpenClaw에서 채팅용 RunAPI를 설정했다면 완료입니다. 동일한 RUNAPI_API_KEY와 /v1 endpoint가 이미지 생성을 처리합니다. 그렇지 않다면 OpenClaw 가이드의 설정 프롬프트를 붙여넣거나 쉘에서 key를 내보내세요.
export RUNAPI_API_KEY=runapi_xxx
Seedream 호출
model을 seedream-4.5-text-to-image로 설정하여 text_to_image endpoint에 요청을 보내세요. 이미지를 설명하는 텍스트 프롬프트를 포함하세요. RunAPI는 즉시 task ID를 반환합니다.
text_to_image
결과 가져오기
반환된 task ID로 task status endpoint를 폴링하세요. status가 completed로 변경되면, 응답에 생성된 이미지 URL이 포함됩니다. RunAPI SDK는 폴링을 자동으로 처리합니다.
task_id: tsk_abc123
Seedream API 파라미터
| 파라미터 | 유형 | 설명 |
|---|---|---|
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 |
편집 모드를 위한 소스 이미지. |
OpenClaw의 Seedream이란?
Seedream은 ByteDance의 이미지 모델로 4K 품질과 94%의 텍스트 정확도를 바로 발휘합니다. 복잡한 프롬프트——여러 객체·특정 공간 관계·상세한 타이포그래피——에서도 일관성을 유지합니다. OpenClaw agent는 RunAPI의 text_to_image 엔드포인트를 통해 채팅과 동일한 API 키로 호출합니다.
Seedream 활용 사례
이커머스 제품 카탈로그
정확한 레이블과 가격 텍스트가 포함된 제품 라이프스타일 사진을 생성해 후처리 텍스트 오버레이 없이 카탈로그 페이지에 바로 사용합니다.
타이포그래피 중심 포스터 및 이벤트 디자인
프롬프트에서 지정한 텍스트 콘텐츠가 94% 이상의 정확도로 렌더링된 이벤트 포스터·표지판·빌보드를 제작합니다.
브랜드 캠페인 일괄 생성
수십 장의 이미지에 걸쳐 동일한 브랜드 앰배서더 외모와 하우스 스타일을 유지하면서 일관된 캐릭터 또는 제품 시리즈를 생성합니다.
Seedream + OpenClaw 자주 묻는 질문
네. OpenClaw에서 RunAPI를 OpenAI 호환 provider로 설정한 뒤, model을 seedream-4.5-text-to-image로 설정하여 text_to_image endpoint를 호출하세요. 동일한 API key로 채팅과 이미지 생성이 모두 가능합니다.
아니요. 채팅에 설정한 동일한 RUNAPI_API_KEY로 Seedream과 RunAPI 카탈로그의 다른 모든 이미지 모델을 호출할 수 있습니다. 하나의 key, 하나의 결제 계정입니다.
비동기입니다. RunAPI는 첫 번째 호출 시 즉시 task ID를 반환합니다. status가 completed가 될 때까지 task status endpoint를 폴링한 뒤, 응답에서 이미지 URL을 가져오세요. SDK와 CLI는 폴링을 자동으로 처리합니다.
Seedream은 생성당 가격으로 청구됩니다. 현재 요금은 RunAPI 가격 페이지에서 확인하세요. 실패한 생성에는 요금이 부과되지 않습니다.
지금 OpenClaw에서 Seedream을 사용해보세요.
무료 RunAPI key를 발급받고, OpenClaw에 프롬프트를 붙여넣어 Seedream으로 4K 이미지를 생성해보세요.