--- title: RunAPI를 통해 WorkBuddy에서 Seedream 사용하기 — MCP 가이드 | RunAPI description: RunAPI를 통해 WorkBuddy에서 Seedream으로 4K 이미지를 생성하세요. 하나의 MCP 서버로 워크벤치에 텍스트-이미지 및 편집 도구와 비동기 폴링 처리를 제공합니다. url: https://runapi.ai/ko/workbuddy-seedream.md canonical: https://runapi.ai/ko/workbuddy-seedream locale: ko site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-seedream zh-CN: https://runapi.ai/zh-CN/workbuddy-seedream es: https://runapi.ai/es/workbuddy-seedream ja: https://runapi.ai/ja/workbuddy-seedream de: https://runapi.ai/de/workbuddy-seedream fr: https://runapi.ai/fr/workbuddy-seedream pt-BR: https://runapi.ai/pt-BR/workbuddy-seedream ko: https://runapi.ai/ko/workbuddy-seedream it: https://runapi.ai/it/workbuddy-seedream nl: https://runapi.ai/nl/workbuddy-seedream pl: https://runapi.ai/pl/workbuddy-seedream tr: https://runapi.ai/tr/workbuddy-seedream zh-TW: https://runapi.ai/zh-TW/workbuddy-seedream zh-HK: https://runapi.ai/zh-HK/workbuddy-seedream ar: https://runapi.ai/ar/workbuddy-seedream x-default: https://runapi.ai/workbuddy-seedream model: seedream --- > HTML version: https://runapi.ai/ko/workbuddy-seedream > Site index for agents: https://runapi.ai/llms.txt # WorkBuddy에서 Seedream을 사용하세요. Seedream은 강력한 타이포그래피 렌더링과 최대 4K 출력을 갖춘 ByteDance의 이미지 생성 모델입니다. WorkBuddy는 runapi MCP 서버를 통해 이를 호출합니다 — 채팅을 커버하는 동일한 서버와 RUNAPI_API_KEY로 Seedream을 워크벤치의 호출 가능한 도구로 제공하며, 추가 공급자 계정이 필요 없습니다. - [API Key 받기](https://runapi.ai/ko/login) - [문서 읽기](https://runapi.ai/ko/docs/guides) 하나의 MCP 서버 · 4K 텍스트-이미지 · 비동기 폴링 처리 ### 프롬프트 ```text Generate a 4K product hero image using Seedream through the runapi MCP server. Requirements: - Call the image generation tool exposed by the runapi MCP server. - Set model to "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." - Wait for the task to complete and return the generated image URL. ``` ### MCP 설정 ```bash { "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### 응답 ```json { "task_id": "tsk_abc123", "status": "completed", "model": "seedream-4.5-text-to-image", "output": { "image_url": "https://media.runapi.ai/outputs/tsk_abc123.png" } } ``` ## 세 단계로 WorkBuddy에서 Seedream 사용하기 1. **RunAPI MCP 서버 추가** - WorkBuddy에서 runapi라는 이름의 MCP 서버를 등록하고 스트리밍 가능한 HTTP를 통해 https://runapi.ai/mcp 를 가리키도록 설정하세요. Authorization 헤더에 RUNAPI_API_KEY의 키를 입력합니다. RunAPI가 이미 WorkBuddy에서 채팅용으로 연결되어 있다면 완료입니다 — 동일한 서버에서 Seedream도 제공됩니다. `url: https://runapi.ai/mcp` 2. **워크벤치 에이전트에 프롬프트 입력** - 모델 seedream-4.5-text-to-image와 장면을 설명하는 텍스트 프롬프트로 이미지를 생성하도록 WorkBuddy에 요청하세요. 이미지에 삽입할 텍스트도 포함하세요. 더 빠르고 저렴한 초안이 필요할 때는 슬러그를 seedream-5-lite-text-to-image로 전환하세요. `Generate a 4K hero image with Seedream` 3. **결과 가져오기** - WorkBuddy가 RunAPI MCP 도구를 호출하면 생성이 비동기 작업으로 실행되고 상태를 자동으로 폴링합니다. 상태가 completed로 변경되면 에이전트가 워크벤치에 생성된 이미지 URL을 보고합니다. `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` | seedream-4.5-edit의 편집 모드에 사용할 소스 이미지. | ## WorkBuddy의 Seedream이란? Seedream은 "비교 불가한 가성비"와 기본적으로 94%의 텍스트 정확도를 갖춘 4K 품질 출력을 제공하는 ByteDance의 이미지 모델입니다. 복잡한 프롬프트 — 여러 오브젝트, 특정 공간 관계, 세밀한 타이포그래피 — 에서도 일관성을 잃지 않고 구조를 유지합니다. WorkBuddy는 카탈로그의 다른 모든 모델을 커버하는 동일한 RUNAPI_API_KEY를 사용해 runapi MCP 서버를 통해 접근합니다. ## Seedream 활용 사례 - **이커머스 상품 카탈로그** - 정확한 라벨과 가격 텍스트가 이미지에 포함된 상품 라이프스타일 사진을 생성하여, 후반 작업 텍스트 오버레이 없이 바로 카탈로그 페이지에 사용할 수 있습니다. - **텍스트 중심 포스터 및 이벤트 디자인** - 프롬프트에 지정한 텍스트가 94% 이상의 정확도로 렌더링된 이벤트 포스터, 간판, 빌보드를 제작합니다. - **브랜드 캠페인 일괄 생성** - 워크벤치 에이전트에게 수십 장의 이미지에서 일관된 캐릭터 또는 제품 시리즈를 생성하도록 요청하세요. 동일한 브랜드 앰버서더 외모와 하우스 스타일을 전반에 걸쳐 유지합니다. ## Seedream + WorkBuddy 질문 ### WorkBuddy에서 Seedream을 어떻게 사용하나요? RUNAPI_API_KEY와 함께 https://runapi.ai/mcp 를 가리키는 runapi라는 MCP 서버로 RunAPI를 추가한 후, 모델 seedream-4.5-text-to-image로 이미지를 생성하도록 워크벤치 에이전트에게 지시하세요. 에이전트가 RunAPI MCP 도구를 호출하고 완성된 이미지 URL을 반환합니다. ### Seedream에 별도의 API 키가 필요한가요? 아니요. runapi MCP 서버에 사용하는 동일한 RUNAPI_API_KEY로 Seedream 및 RunAPI 카탈로그의 다른 모든 이미지 모델도 호출됩니다. 키 하나, 결제 계정 하나입니다. ### Seedream은 비동기 방식이며, WorkBuddy가 대기를 처리하나요? 생성은 task_id를 반환하는 비동기 작업으로 실행됩니다. RunAPI MCP 서버가 상태 폴링을 처리하므로, WorkBuddy 에이전트는 상태가 completed가 되면 이미지 URL을 보고합니다. 실패한 생성은 과금되지 않습니다. ### Seedream이 여러 이미지에서 캐릭터 일관성을 유지할 수 있나요? 네. 프롬프트에서 캐릭터를 상세히 묘사하면 Seedream이 얼굴 특징, 신체 비율, 의상 스타일을 배치 이미지 전반에 걸쳐 일관되게 유지합니다. 브랜드 앰배서더 시리즈나 제품 모델 시퀀스에 적합합니다. ### Seedream 4.5와 Seedream 5 Lite의 차이점은 무엇인가요? Seedream 4.5는 4K 출력과 최고 수준의 충실도를 갖춘 풀 모델입니다. Seedream 5 Lite는 표준 해상도에서 속도에 최적화된 더 빠르고 저렴한 변형입니다. 두 모델 모두 동일한 runapi MCP server를 통해 제공됩니다. 빠른 생성에는 model slug를 seedream-5-lite-text-to-image로, 최고 품질에는 seedream-4.5-text-to-image로 설정하세요. - [WorkBuddy 설정 가이드 →](https://runapi.ai/ko/workbuddy.md) - 아직 설정하지 않으셨나요? WorkBuddy를 위한 RunAPI MCP 설정 가이드부터 시작하세요. - [Seedream 모델 →](https://runapi.ai/ko/models/seedream.md) - 모든 Seedream 변형, 가격 및 API 문서를 확인하세요. ## 지금 바로 WorkBuddy에서 Seedream을 사용해 보세요. 무료 RunAPI 키를 발급받고, WorkBuddy에 MCP server를 추가한 뒤 Seedream으로 4K 이미지를 생성해 보세요. [모델 보기 →](https://runapi.ai/ko/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/ko/.md) ### 제품 - [모델 카탈로그](https://runapi.ai/ko/models.md) - [요금](https://runapi.ai/ko/pricing.md) - [제공사](https://runapi.ai/ko/models#all-models) ### 개발자 - [문서](https://runapi.ai/ko/docs/guides) - [SDK](https://runapi.ai/ko/sdk.md) - [CLI](https://runapi.ai/ko/cli.md) - [MCP Server](https://runapi.ai/ko/mcp.md) - [x402](https://runapi.ai/ko/x402.md) ### 가이드 - [Claude Code와 Cursor](https://runapi.ai/ko/claude-code-vs-cursor.md) - [Cursor API 설정](https://runapi.ai/ko/cursor-api-setup.md) - [RunAPI와 OpenRouter 비교](https://runapi.ai/ko/openrouter-alternative.md) ### 회사 - [엔터프라이즈](https://runapi.ai/ko/contact.md) - [문의](https://runapi.ai/ko/contact.md) ### 법적 고지 - [약관](https://runapi.ai/ko/terms.md) - [개인정보](https://runapi.ai/ko/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "ko", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/ko", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/ko/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/ko", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/koicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "SoftwareApplication", "name": "WorkBuddy를 위한 RunAPI Seedream", "applicationCategory": "DeveloperApplication", "description": "RunAPI를 통해 WorkBuddy에서 Seedream으로 4K 이미지를 생성하세요. 하나의 MCP 서버로 워크벤치에 텍스트-이미지 및 편집 도구와 비동기 폴링 처리를 제공합니다.", "url": "https://runapi.ai/ko/workbuddy-seedream" }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "WorkBuddy에서 Seedream을 어떻게 사용하나요?", "acceptedAnswer": { "@type": "Answer", "text": "RUNAPI_API_KEY와 함께 https://runapi.ai/mcp 를 가리키는 runapi라는 MCP 서버로 RunAPI를 추가한 후, 모델 seedream-4.5-text-to-image로 이미지를 생성하도록 워크벤치 에이전트에게 지시하세요. 에이전트가 RunAPI MCP 도구를 호출하고 완성된 이미지 URL을 반환합니다." } }, { "@type": "Question", "name": "Seedream에 별도의 API 키가 필요한가요?", "acceptedAnswer": { "@type": "Answer", "text": "아니요. runapi MCP 서버에 사용하는 동일한 RUNAPI_API_KEY로 Seedream 및 RunAPI 카탈로그의 다른 모든 이미지 모델도 호출됩니다. 키 하나, 결제 계정 하나입니다." } }, { "@type": "Question", "name": "Seedream은 비동기 방식이며, WorkBuddy가 대기를 처리하나요?", "acceptedAnswer": { "@type": "Answer", "text": "생성은 task_id를 반환하는 비동기 작업으로 실행됩니다. RunAPI MCP 서버가 상태 폴링을 처리하므로, WorkBuddy 에이전트는 상태가 completed가 되면 이미지 URL을 보고합니다. 실패한 생성은 과금되지 않습니다." } }, { "@type": "Question", "name": "Seedream이 여러 이미지에서 캐릭터 일관성을 유지할 수 있나요?", "acceptedAnswer": { "@type": "Answer", "text": "네. 프롬프트에서 캐릭터를 상세히 묘사하면 Seedream이 얼굴 특징, 신체 비율, 의상 스타일을 배치 이미지 전반에 걸쳐 일관되게 유지합니다. 브랜드 앰배서더 시리즈나 제품 모델 시퀀스에 적합합니다." } }, { "@type": "Question", "name": "Seedream 4.5와 Seedream 5 Lite의 차이점은 무엇인가요?", "acceptedAnswer": { "@type": "Answer", "text": "Seedream 4.5는 4K 출력과 최고 수준의 충실도를 갖춘 풀 모델입니다. Seedream 5 Lite는 표준 해상도에서 속도에 최적화된 더 빠르고 저렴한 변형입니다. 두 모델 모두 동일한 runapi MCP server를 통해 제공됩니다. 빠른 생성에는 model slug를 seedream-5-lite-text-to-image로, 최고 품질에는 seedream-4.5-text-to-image로 설정하세요." } } ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "HowTo", "name": "RunAPI를 통해 WorkBuddy에서 Seedream 사용하는 방법", "description": "WorkBuddy에서 RunAPI를 MCP 서버로 추가하고, 워크벤치 에이전트에게 Seedream으로 4K 이미지를 생성하도록 지시하세요.", "step": [ { "@type": "HowToStep", "position": 1, "name": "RunAPI MCP 서버 추가", "text": "WorkBuddy에서 runapi라는 이름의 MCP 서버를 등록하고 스트리밍 가능한 HTTP를 통해 https://runapi.ai/mcp 를 가리키도록 설정하세요. Authorization 헤더에 RUNAPI_API_KEY의 키를 입력합니다. RunAPI가 이미 WorkBuddy에서 채팅용으로 연결되어 있다면 완료입니다 — 동일한 서버에서 Seedream도 제공됩니다.", "url": "https://runapi.ai/ko/workbuddy-seedream#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "워크벤치 에이전트에 프롬프트 입력", "text": "모델 seedream-4.5-text-to-image와 장면을 설명하는 텍스트 프롬프트로 이미지를 생성하도록 WorkBuddy에 요청하세요. 이미지에 삽입할 텍스트도 포함하세요. 더 빠르고 저렴한 초안이 필요할 때는 슬러그를 seedream-5-lite-text-to-image로 전환하세요.", "url": "https://runapi.ai/ko/workbuddy-seedream#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "결과 가져오기", "text": "WorkBuddy가 RunAPI MCP 도구를 호출하면 생성이 비동기 작업으로 실행되고 상태를 자동으로 폴링합니다. 상태가 completed로 변경되면 에이전트가 워크벤치에 생성된 이미지 URL을 보고합니다.", "url": "https://runapi.ai/ko/workbuddy-seedream#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "홈", "item": "https://runapi.ai/ko" }, { "@type": "ListItem", "position": 2, "name": "WorkBuddy를 위한 RunAPI Seedream", "item": "https://runapi.ai/ko/workbuddy-seedream" } ] } ] ```