--- title: RunAPI를 통해 WorkBuddy에서 Topaz 사용하기 — 업스케일링 가이드 | RunAPI description: RunAPI MCP 서버를 통해 WorkBuddy에서 Topaz로 이미지를 업스케일하세요. API 키 하나로 최대 4배 해상도 향상, 비동기 작업은 워크벤치 에이전트가 처리합니다. url: https://runapi.ai/ko/workbuddy-topaz.md canonical: https://runapi.ai/ko/workbuddy-topaz locale: ko site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-topaz zh-CN: https://runapi.ai/zh-CN/workbuddy-topaz es: https://runapi.ai/es/workbuddy-topaz ja: https://runapi.ai/ja/workbuddy-topaz de: https://runapi.ai/de/workbuddy-topaz fr: https://runapi.ai/fr/workbuddy-topaz pt-BR: https://runapi.ai/pt-BR/workbuddy-topaz ko: https://runapi.ai/ko/workbuddy-topaz it: https://runapi.ai/it/workbuddy-topaz nl: https://runapi.ai/nl/workbuddy-topaz pl: https://runapi.ai/pl/workbuddy-topaz tr: https://runapi.ai/tr/workbuddy-topaz zh-TW: https://runapi.ai/zh-TW/workbuddy-topaz zh-HK: https://runapi.ai/zh-HK/workbuddy-topaz ar: https://runapi.ai/ar/workbuddy-topaz x-default: https://runapi.ai/workbuddy-topaz model: topaz --- > HTML version: https://runapi.ai/ko/workbuddy-topaz > Site index for agents: https://runapi.ai/llms.txt # WorkBuddy에서 Topaz를 사용하세요. Topaz Labs의 Topaz는 아티팩트 없이 디테일을 복원하는 신경망을 사용해 이미지를 최대 4배 해상도로 업스케일합니다. WorkBuddy는 MCP를 기본 지원합니다 — RunAPI를 MCP 서버로 추가하고, 에이전트에 이미지 URL과 배율을 전달하면 향상된 결과를 워크벤치로 반환합니다. - [API Key 받기](https://runapi.ai/ko/login) - [문서 읽기](https://runapi.ai/ko/docs/guides) MCP 서버 하나 · API 키 하나 · 에이전트가 비동기 작업 처리 ### 프롬프트 ```text Use the runapi MCP server to upscale an image with Topaz. Requirements: - Call the RunAPI upscale tool with model set to "topaz-upscale-image". - Image URL: https://example.com/photo.jpg - Set scale to 4. - Wait until the task completes, then give me the upscaled 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": "topaz-upscale-image", "output": { "image_url": "https://runapi.ai/files/tsk_abc123_4x.png" } } ``` ## 세 단계로 WorkBuddy에서 Topaz 사용하기 1. **RunAPI MCP 서버 추가** - WorkBuddy에서 runapi라는 이름의 MCP 서버를 등록하고 스트리밍 가능한 HTTP를 통해 https://runapi.ai/mcp 를 가리키도록 설정하세요. Authorization 헤더에 RUNAPI_API_KEY의 키를 입력합니다. 채팅이나 이미지 생성에 RunAPI가 이미 연결되어 있다면, 동일한 서버에서 Topaz도 제공됩니다. `url: https://runapi.ai/mcp` 2. **워크벤치 에이전트에 프롬프트 입력** - 소스 image_url, topaz-upscale-image로 설정된 모델, 선택적으로 1, 2, 4 중 하나의 배율을 포함해 WorkBuddy에 프롬프트를 붙여넣으세요. 에이전트가 요청을 RunAPI 업스케일 도구에 매핑합니다. `model: topaz-upscale-image` 3. **에이전트가 결과를 반환하도록 설정** - 도구 호출은 pending 상태의 비동기 작업을 생성합니다. WorkBuddy가 대기를 처리하고 작업이 완료되면 업스케일된 이미지 URL을 대화에 게시합니다. `task_id: tsk_abc123` ## Topaz 업스케일 API 파라미터 | 파라미터 | 유형 | 설명 | | --- | --- | --- | | `model` | `string` | 필수. topaz-upscale-image 또는 topaz-upscale-video. | | `image_url` | `string` | 업스케일할 이미지의 URL. | | `scale` | `integer` | 선택. 업스케일 배율: 1, 2, 또는 4. 기본값은 2. | | `callback_url` | `string` | 선택 사항. 비동기 완료 알림을 위한 Webhook URL입니다. | ## WorkBuddy의 Topaz란? Topaz는 사진작가들이 "사진 충실도의 표준"이라고 부르는 전문가급 이미지 마감 도구입니다. 소스 이미지에 충실한 선명한 결과로 최대 4배 해상도로 이미지를 업스케일합니다 — 원본에 없던 AI 생성 디테일을 추가하는 일부 업스케일러와 달리 원본을 그대로 유지합니다. RunAPI에서는 데스크탑 앱 구독이 아닌 API 기반 MCP 도구로 실행되므로, WorkBuddy 에이전트가 자동화 파이프라인의 모든 생성 단계 후 업스케일링을 연결할 수 있습니다. ## Topaz 활용 사례 - **AI 생성 이미지를 인쇄 품질로 업스케일** - 동일한 MCP 서버의 모든 생성 모델 출력물을 가져와 상업용 인쇄 라이선싱, 대형 포스터, 패키징을 위한 8K 해상도로 업스케일하세요 — 모두 하나의 WorkBuddy 대화에서 가능합니다. - **노이즈 제거 및 얼굴 복원** - 저조도 환경의 노이즈가 있는 사진을 정리하고 인물 사진의 흐릿한 얼굴을 복원하여, 압축이나 열악한 촬영 환경으로 손실된 디테일을 되살립니다. - **대용량 사진 컬렉션 일괄 처리** - WorkBuddy에 수백 장의 제품 사진이나 아카이브 이미지를 단일 자동화 작업으로 업스케일 처리하도록 요청하세요. 각 이미지는 독립적인 비동기 작업으로 처리됩니다. ## Topaz + WorkBuddy 질문 ### WorkBuddy에서 Topaz를 사용할 수 있나요? 네. WorkBuddy는 MCP를 기본 지원합니다. RunAPI를 RUNAPI_API_KEY와 함께 https://runapi.ai/mcp 를 가리키는 MCP 서버로 추가한 후, 에이전트에게 topaz-upscale-image로 설정된 모델로 업스케일 도구를 호출하도록 요청하세요. ### Topaz에 별도의 API 키가 필요한가요? 아니요. runapi MCP 서버에 사용하는 동일한 RUNAPI_API_KEY로 Topaz 업스케일링도 처리됩니다. 모든 RunAPI 모델은 하나의 API 키와 하나의 크레딧 잔액을 공유합니다. ### Topaz 업스케일링은 비동기인가요, 동기인가요? 비동기 방식입니다. 도구 호출은 즉시 task_id를 반환하며, WorkBuddy 에이전트가 업스케일된 이미지가 준비될 때까지 대신 대기한 후 대화에 URL을 반환합니다 — 수동 폴링이 필요 없습니다. ### Topaz 업스케일링의 요금은 어떻게 되나요? Topaz는 RunAPI를 통해 작업당 종량제 요금이 적용됩니다. 현재 요금은 RunAPI 요금 페이지를 확인하세요. $199/년의 Topaz 데스크탑 앱 구독과 달리 월정액이나 최소 지출이 없습니다. ### 특정 이미지 유형에서 품질이 저하되나요? Topaz는 사진 콘텐츠에 가장 적합합니다. 심하게 압축된 이미지, 매우 작은 소스 파일, 또는 AI 아티팩트가 있는 이미지는 높은 배율에서 플라스틱처럼 보이거나 과도하게 부드러워질 수 있습니다. 배치 작업에서 4x를 적용하기 전에 2x로 먼저 품질을 테스트해 보세요. - [WorkBuddy 설정 가이드 →](https://runapi.ai/ko/workbuddy.md) - 아직 연결하지 않으셨나요? WorkBuddy용 RunAPI MCP 설정 가이드를 참조하세요. - [Topaz 모델 →](https://runapi.ai/ko/models/topaz.md) - 모든 Topaz 변형 모델, 요금 및 API 문서를 확인하세요. ## 지금 바로 WorkBuddy에서 Topaz를 사용해 보세요. 무료 RunAPI 키를 발급받고, WorkBuddy에 MCP 서버를 추가한 후, 워크벤치에서 Topaz로 이미지 업스케일을 시작하세요. [모델 보기 →](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 Topaz", "applicationCategory": "DeveloperApplication", "description": "RunAPI MCP 서버를 통해 WorkBuddy에서 Topaz로 이미지를 업스케일하세요. API 키 하나로 최대 4배 해상도 향상, 비동기 작업은 워크벤치 에이전트가 처리합니다.", "url": "https://runapi.ai/ko/workbuddy-topaz" }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "WorkBuddy에서 Topaz를 사용할 수 있나요?", "acceptedAnswer": { "@type": "Answer", "text": "네. WorkBuddy는 MCP를 기본 지원합니다. RunAPI를 RUNAPI_API_KEY와 함께 https://runapi.ai/mcp 를 가리키는 MCP 서버로 추가한 후, 에이전트에게 topaz-upscale-image로 설정된 모델로 업스케일 도구를 호출하도록 요청하세요." } }, { "@type": "Question", "name": "Topaz에 별도의 API 키가 필요한가요?", "acceptedAnswer": { "@type": "Answer", "text": "아니요. runapi MCP 서버에 사용하는 동일한 RUNAPI_API_KEY로 Topaz 업스케일링도 처리됩니다. 모든 RunAPI 모델은 하나의 API 키와 하나의 크레딧 잔액을 공유합니다." } }, { "@type": "Question", "name": "Topaz 업스케일링은 비동기인가요, 동기인가요?", "acceptedAnswer": { "@type": "Answer", "text": "비동기 방식입니다. 도구 호출은 즉시 task_id를 반환하며, WorkBuddy 에이전트가 업스케일된 이미지가 준비될 때까지 대신 대기한 후 대화에 URL을 반환합니다 — 수동 폴링이 필요 없습니다." } }, { "@type": "Question", "name": "Topaz 업스케일링의 요금은 어떻게 되나요?", "acceptedAnswer": { "@type": "Answer", "text": "Topaz는 RunAPI를 통해 작업당 종량제 요금이 적용됩니다. 현재 요금은 RunAPI 요금 페이지를 확인하세요. $199/년의 Topaz 데스크탑 앱 구독과 달리 월정액이나 최소 지출이 없습니다." } }, { "@type": "Question", "name": "특정 이미지 유형에서 품질이 저하되나요?", "acceptedAnswer": { "@type": "Answer", "text": "Topaz는 사진 콘텐츠에 가장 적합합니다. 심하게 압축된 이미지, 매우 작은 소스 파일, 또는 AI 아티팩트가 있는 이미지는 높은 배율에서 플라스틱처럼 보이거나 과도하게 부드러워질 수 있습니다. 배치 작업에서 4x를 적용하기 전에 2x로 먼저 품질을 테스트해 보세요." } } ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "HowTo", "name": "RunAPI를 통해 WorkBuddy에서 Topaz 사용하는 방법", "description": "WorkBuddy에서 RunAPI를 MCP 서버로 추가하고, 워크벤치 에이전트에게 Topaz 업스케일 도구로 이미지 해상도를 향상시키도록 지시하세요.", "step": [ { "@type": "HowToStep", "position": 1, "name": "RunAPI MCP 서버 추가", "text": "WorkBuddy에서 runapi라는 이름의 MCP 서버를 등록하고 스트리밍 가능한 HTTP를 통해 https://runapi.ai/mcp 를 가리키도록 설정하세요. Authorization 헤더에 RUNAPI_API_KEY의 키를 입력합니다. 채팅이나 이미지 생성에 RunAPI가 이미 연결되어 있다면, 동일한 서버에서 Topaz도 제공됩니다.", "url": "https://runapi.ai/ko/workbuddy-topaz#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "워크벤치 에이전트에 프롬프트 입력", "text": "소스 image_url, topaz-upscale-image로 설정된 모델, 선택적으로 1, 2, 4 중 하나의 배율을 포함해 WorkBuddy에 프롬프트를 붙여넣으세요. 에이전트가 요청을 RunAPI 업스케일 도구에 매핑합니다.", "url": "https://runapi.ai/ko/workbuddy-topaz#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "에이전트가 결과를 반환하도록 설정", "text": "도구 호출은 pending 상태의 비동기 작업을 생성합니다. WorkBuddy가 대기를 처리하고 작업이 완료되면 업스케일된 이미지 URL을 대화에 게시합니다.", "url": "https://runapi.ai/ko/workbuddy-topaz#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 Topaz", "item": "https://runapi.ai/ko/workbuddy-topaz" } ] } ] ```