--- title: RunAPI를 통해 WorkBuddy에서 Z Image 사용하기 — 이미지 API 가이드 | RunAPI description: RunAPI MCP 서버를 통해 WorkBuddy에서 Alibaba Z Image로 이미지를 생성하세요. API 키 하나로 이중 언어 텍스트 렌더링과 빠른 텍스트-투-이미지를 워크벤치에서 이용할 수 있습니다. url: https://runapi.ai/ko/workbuddy-z-image.md canonical: https://runapi.ai/ko/workbuddy-z-image locale: ko site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-z-image zh-CN: https://runapi.ai/zh-CN/workbuddy-z-image es: https://runapi.ai/es/workbuddy-z-image ja: https://runapi.ai/ja/workbuddy-z-image de: https://runapi.ai/de/workbuddy-z-image fr: https://runapi.ai/fr/workbuddy-z-image pt-BR: https://runapi.ai/pt-BR/workbuddy-z-image ko: https://runapi.ai/ko/workbuddy-z-image it: https://runapi.ai/it/workbuddy-z-image nl: https://runapi.ai/nl/workbuddy-z-image pl: https://runapi.ai/pl/workbuddy-z-image tr: https://runapi.ai/tr/workbuddy-z-image zh-TW: https://runapi.ai/zh-TW/workbuddy-z-image zh-HK: https://runapi.ai/zh-HK/workbuddy-z-image ar: https://runapi.ai/ar/workbuddy-z-image x-default: https://runapi.ai/workbuddy-z-image model: z-image --- > HTML version: https://runapi.ai/ko/workbuddy-z-image > Site index for agents: https://runapi.ai/llms.txt # WorkBuddy에서 Z Image를 사용하세요. Z Image는 중국어와 영어 이중 언어 텍스트 렌더링을 지원하는 Alibaba의 빠른 이미지 생성 모델입니다. WorkBuddy는 MCP를 기본 지원하므로, RunAPI를 MCP 서버로 한 번 추가하면 워크벤치 에이전트가 다른 모든 모델과 동일한 RUNAPI_API_KEY로 Z Image를 도구로 호출할 수 있습니다. - [API Key 받기](https://runapi.ai/ko/login) - [문서 읽기](https://runapi.ai/ko/docs/guides) MCP 서버 하나 · API 키 하나 · 에이전트가 비동기 작업 처리 ### 프롬프트 ```text Use the runapi MCP server to generate an image with Z Image. Requirements: - Call the RunAPI text-to-image tool with model set to "z-image". - Prompt: "A neon-lit Tokyo street at night with Japanese shop signs, cinematic lighting, 8K detail". - Wait until the task completes, then give me the final 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": "z-image", "output": { "image_url": "https://runapi.ai/files/tsk_abc123.png" } } ``` ## WorkBuddy에서 Z Image를 3단계로 사용하기 1. **RunAPI MCP 서버 추가** - WorkBuddy에서 runapi라는 이름의 MCP 서버를 등록하고 streamable HTTP 방식으로 https://runapi.ai/mcp를 가리키도록 설정하세요. Authorization 헤더에서 RUNAPI_API_KEY의 키를 읽어옵니다. 이미 다른 모델용으로 RunAPI가 연결되어 있다면 이 단계를 건너뛰세요. 동일한 서버에서 Z Image가 노출됩니다. `url: https://runapi.ai/mcp` 2. **워크벤치 에이전트에 프롬프트 입력** - 프롬프트를 WorkBuddy에 붙여넣고 model을 z-image로 설정하여 runapi MCP 서버를 사용하도록 요청하세요. Z Image는 중국어, 영어 또는 두 언어 모두로 프롬프트를 입력받아 각 문자를 정확하게 렌더링합니다. `model: z-image` 3. **에이전트가 결과를 반환하도록 설정** - WorkBuddy는 RunAPI 텍스트-이미지 도구를 호출하여 비동기 작업을 생성합니다. 에이전트가 대기를 처리하고 작업이 완료되면 완성된 이미지 URL을 대화에 반환합니다. `task_id: tsk_abc123` ## Z Image API 파라미터 | 파라미터 | 유형 | 설명 | | --- | --- | --- | | `model` | `string` | 필수. z-image를 사용하세요. | | `prompt` | `string` | 텍스트 설명. 중국어 및 영어를 지원합니다. | | `negative_prompt` | `string` | 선택. 이미지에서 제외할 요소. | | `size` | `string` | 선택. 출력 크기. 예: 1024x1024. | | `callback_url` | `string` | 선택 사항. 비동기 완료 알림을 위한 Webhook URL입니다. | ## WorkBuddy의 Z Image란? Z Image는 속도 최적화 이미지 모델로, 사용자들이 "놀랍다"고 평가하는 초고속 생성과 초실감 출력이 특징입니다. Apache 2.0 오픈 소스로 구동되며, 중국어와 영어 이중 언어 텍스트를 렌더링하고, 다른 고속 모델이 놓치는 세밀한 얼굴 디테일까지 포착합니다. RunAPI를 통해 이미지당 약 $0.004로 가장 저렴한 옵션 중 하나입니다. WorkBuddy에서는 runapi MCP 서버의 도구로 제공되어, 워크벤치 에이전트가 대화를 벗어나지 않고 작업 중 이미지를 생성할 수 있습니다. ## Z Image 활용 사례 - **컨셉 탐색 및 빠른 프로토타이핑** - WorkBuddy에 수십 가지 시각적 방향을 요청하고 몇 초 안에 이미지당 몇 분의 일 센트로 결과를 받아보세요 — 더 비싼 모델로 최종 출력을 확정하기 전에 폭넓게 탐색하세요. - **이중 언어 마케팅 캠페인** - 하나의 이미지에 정확하게 렌더링된 중국어와 영어 텍스트가 포함된 마케팅 시각 자료를 제작하세요. 워크벤치에서 바로 제작하는 크로스보더 이커머스 및 다국어 소셜 미디어에 유용합니다. - **패션 및 제품 사진 목업** - 정확한 재질 텍스처와 조명으로 실감 나는 제품 사진 목업을 생성하세요. 에이전트와 함께 브리프를 다듬는 동안 실시간으로 구도를 반복 작업할 수 있을 만큼 빠릅니다. ## Z Image + WorkBuddy 질문 ### WorkBuddy에서 Z Image를 사용할 수 있나요? 네. WorkBuddy는 MCP를 기본 지원합니다. RunAPI를 https://runapi.ai/mcp 를 가리키는 MCP 서버로 추가하고 RUNAPI_API_KEY를 설정하면, 워크벤치 에이전트가 모델을 z-image로 설정해 텍스트-이미지 도구를 호출할 수 있습니다. ### Z Image에 별도의 API 키가 필요한가요? 아니요. runapi MCP 서버에 사용하는 동일한 RUNAPI_API_KEY로 Z Image도 커버됩니다. 모든 RunAPI 모델은 하나의 키와 하나의 크레딧 잔액을 공유하므로 모델별로 추가 설정이 필요 없습니다. ### Z Image는 비동기인가요, 동기인가요? Z Image는 비동기 방식입니다. 도구 호출은 즉시 task_id를 반환하며, WorkBuddy 에이전트가 후속 처리를 대신합니다 — 작업 완료를 기다렸다가 대화에 이미지 URL을 반환합니다. ### Z Image의 요금은 어떻게 되나요? Z Image는 이미지당 약 $0.004의 종량제 요금을 사용하여 RunAPI에서 가장 저렴한 옵션 중 하나입니다. 현재 요금은 RunAPI 요금 페이지를 확인하세요. 월정액 구독이나 최소 지출 금액은 없습니다. ### Z Image는 Flux 또는 Nano Banana와 어떻게 비교되나요? Z Image는 속도와 비용 면에서 우수합니다 — 이미지당 몇 분의 일 센트로 초고속 생성이 가능합니다. Flux 2와 Nano Banana는 더 높은 품질의 출력을 제공하지만 비용이 5~10배 더 들고 시간도 더 걸립니다. 대량 작업과 컨셉 탐색에는 Z Image를 사용하고, 최종 선택 시에는 동일한 MCP 서버에서 모델을 전환하세요. - [WorkBuddy 설정 가이드 →](https://runapi.ai/ko/workbuddy.md) - 아직 연결하지 않으셨나요? WorkBuddy용 RunAPI MCP 설정 가이드를 참조하세요. - [Z Image 모델 →](https://runapi.ai/ko/models/z-image.md) - 모든 Z Image 변형 모델, 요금 및 API 문서를 확인하세요. ## 지금 바로 WorkBuddy에서 Z Image를 사용해 보세요. 무료 RunAPI 키를 발급받고, WorkBuddy에 MCP 서버를 추가한 후, 워크벤치에서 이중 언어 텍스트 렌더링으로 이미지를 생성해 보세요. [모델 보기 →](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 Z Image", "applicationCategory": "DeveloperApplication", "description": "RunAPI MCP 서버를 통해 WorkBuddy에서 Alibaba Z Image로 이미지를 생성하세요. API 키 하나로 이중 언어 텍스트 렌더링과 빠른 텍스트-투-이미지를 워크벤치에서 이용할 수 있습니다.", "url": "https://runapi.ai/ko/workbuddy-z-image" }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "WorkBuddy에서 Z Image를 사용할 수 있나요?", "acceptedAnswer": { "@type": "Answer", "text": "네. WorkBuddy는 MCP를 기본 지원합니다. RunAPI를 https://runapi.ai/mcp 를 가리키는 MCP 서버로 추가하고 RUNAPI_API_KEY를 설정하면, 워크벤치 에이전트가 모델을 z-image로 설정해 텍스트-이미지 도구를 호출할 수 있습니다." } }, { "@type": "Question", "name": "Z Image에 별도의 API 키가 필요한가요?", "acceptedAnswer": { "@type": "Answer", "text": "아니요. runapi MCP 서버에 사용하는 동일한 RUNAPI_API_KEY로 Z Image도 커버됩니다. 모든 RunAPI 모델은 하나의 키와 하나의 크레딧 잔액을 공유하므로 모델별로 추가 설정이 필요 없습니다." } }, { "@type": "Question", "name": "Z Image는 비동기인가요, 동기인가요?", "acceptedAnswer": { "@type": "Answer", "text": "Z Image는 비동기 방식입니다. 도구 호출은 즉시 task_id를 반환하며, WorkBuddy 에이전트가 후속 처리를 대신합니다 — 작업 완료를 기다렸다가 대화에 이미지 URL을 반환합니다." } }, { "@type": "Question", "name": "Z Image의 요금은 어떻게 되나요?", "acceptedAnswer": { "@type": "Answer", "text": "Z Image는 이미지당 약 $0.004의 종량제 요금을 사용하여 RunAPI에서 가장 저렴한 옵션 중 하나입니다. 현재 요금은 RunAPI 요금 페이지를 확인하세요. 월정액 구독이나 최소 지출 금액은 없습니다." } }, { "@type": "Question", "name": "Z Image는 Flux 또는 Nano Banana와 어떻게 비교되나요?", "acceptedAnswer": { "@type": "Answer", "text": "Z Image는 속도와 비용 면에서 우수합니다 — 이미지당 몇 분의 일 센트로 초고속 생성이 가능합니다. Flux 2와 Nano Banana는 더 높은 품질의 출력을 제공하지만 비용이 5~10배 더 들고 시간도 더 걸립니다. 대량 작업과 컨셉 탐색에는 Z Image를 사용하고, 최종 선택 시에는 동일한 MCP 서버에서 모델을 전환하세요." } } ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "HowTo", "name": "RunAPI를 통해 WorkBuddy에서 Z Image 사용하는 방법", "description": "WorkBuddy에서 RunAPI를 MCP 서버로 추가한 후, RunAPI 텍스트-투-이미지 도구를 통해 Alibaba Z Image로 이미지를 생성하도록 워크벤치 에이전트에 프롬프트를 입력하세요.", "step": [ { "@type": "HowToStep", "position": 1, "name": "RunAPI MCP 서버 추가", "text": "WorkBuddy에서 runapi라는 이름의 MCP 서버를 등록하고 streamable HTTP 방식으로 https://runapi.ai/mcp를 가리키도록 설정하세요. Authorization 헤더에서 RUNAPI_API_KEY의 키를 읽어옵니다. 이미 다른 모델용으로 RunAPI가 연결되어 있다면 이 단계를 건너뛰세요. 동일한 서버에서 Z Image가 노출됩니다.", "url": "https://runapi.ai/ko/workbuddy-z-image#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "워크벤치 에이전트에 프롬프트 입력", "text": "프롬프트를 WorkBuddy에 붙여넣고 model을 z-image로 설정하여 runapi MCP 서버를 사용하도록 요청하세요. Z Image는 중국어, 영어 또는 두 언어 모두로 프롬프트를 입력받아 각 문자를 정확하게 렌더링합니다.", "url": "https://runapi.ai/ko/workbuddy-z-image#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "에이전트가 결과를 반환하도록 설정", "text": "WorkBuddy는 RunAPI 텍스트-이미지 도구를 호출하여 비동기 작업을 생성합니다. 에이전트가 대기를 처리하고 작업이 완료되면 완성된 이미지 URL을 대화에 반환합니다.", "url": "https://runapi.ai/ko/workbuddy-z-image#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 Z Image", "item": "https://runapi.ai/ko/workbuddy-z-image" } ] } ] ```