---
title: 透過 RunAPI 在 WorkBuddy 中使用 Z Image — 圖像 API 指南 | RunAPI
description: 透過 RunAPI MCP 伺服器在 WorkBuddy 中使用阿里巴巴 Z Image 生成圖像。一個 API key，支援中英雙語文字渲染，從工作台快速文字生圖。
url: https://runapi.ai/zh-HK/workbuddy-z-image.md
canonical: https://runapi.ai/zh-HK/workbuddy-z-image
locale: zh-HK
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/zh-HK/workbuddy-z-image
> Site index for agents: https://runapi.ai/llms.txt


# 在 WorkBuddy 中使用 Z Image。

Z Image 是阿里巴巴的快速圖像生成模型，支援中英雙語文字渲染。WorkBuddy 原生支援 MCP——只需將 RunAPI 新增為 MCP 伺服器一次，工作台代理即可使用與其他所有模型相同的 RUNAPI_API_KEY 將 Z Image 作為工具呼叫。

- [取得 API Key](https://runapi.ai/zh-HK/login)
- [閱讀文件](https://runapi.ai/zh-HK/docs/guides)

一個 MCP 伺服器 · 一個 API key · 代理自動處理異步任務

### 提示詞

```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

1. **新增 RunAPI MCP 伺服器** - 在 WorkBuddy 中註冊一個名為 runapi 的 MCP 伺服器，透過 streamable HTTP 指向 https://runapi.ai/mcp，並在 Authorization 標頭中從 RUNAPI_API_KEY 讀取您的 key。若 RunAPI 已連接用於其他模型，請跳過此步驟——同一伺服器已公開 Z Image。 `url: https://runapi.ai/mcp`
2. **提示工作台代理** - 將提示詞貼入 WorkBuddy，並請其使用 runapi MCP 伺服器，將模型設為 z-image。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 server 上，讓工作台 agent 無需離開對話即可在任務中途生成圖像。

## Z Image 使用場景

- **概念探索及快速原型設計** - 向 WorkBuddy 索取十多個視覺方向，幾秒內以極低成本取得結果——在將更昂貴的模型用於最終輸出前，先廣泛探索。
- **中英雙語行銷推廣** - 在單張圖像中生成包含準確中英文文字的行銷素材，適合直接從工作台製作跨境電商及多語言社交媒體內容。
- **時裝及產品攝影效果圖** - 生成具有準確材質紋理和光線的逼真產品攝影合成圖，速度足夠快，可在與 agent 精煉說明時即時迭代構圖。

## Z Image + WorkBuddy 常見問題

### 我可以在 WorkBuddy 中使用 Z Image 嗎？

可以。WorkBuddy 原生支援 MCP。將 RunAPI 作為 MCP server 指向 https://runapi.ai/mcp 並填入您的 RUNAPI_API_KEY，工作台 agent 便可呼叫文字轉圖像工具，並將 model 設為 z-image。

### 使用 Z Image 需要單獨的 API 金鑰嗎？

不需要。runapi MCP server 背後使用的同一個 RUNAPI_API_KEY 亦涵蓋 Z Image。所有 RunAPI 模型共用一個金鑰和一個點數餘額，無需為每個模型額外設定。

### Z Image 是非同步還是同步？

Z Image 採用非同步方式。工具呼叫會立即返回 task_id，WorkBuddy agent 會替您處理後續步驟——等待任務完成並在對話中返回圖像 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 server 上切換模型。


- [WorkBuddy 設定指南 →](https://runapi.ai/zh-HK/workbuddy.md) - 尚未連接？請先參閱 WorkBuddy 的 RunAPI MCP 設定指南。
- [Z Image 模型 →](https://runapi.ai/zh-HK/models/z-image.md) - 查看所有 Z Image 版本、定價及 API 文件。

## 立即在 WorkBuddy 中試用 Z Image。

取得免費 RunAPI 金鑰，將 MCP server 加入 WorkBuddy，即可從工作台開始生成支援雙語文字渲染的圖像。

[瀏覽模型 →](https://runapi.ai/zh-HK/models.md)

---

## More from RunAPI

- [Home](https://runapi.ai/zh-HK/.md)
### 產品
- [模型目錄](https://runapi.ai/zh-HK/models.md)
- [收費](https://runapi.ai/zh-HK/pricing.md)
- [服務商](https://runapi.ai/zh-HK/models#all-models)
### 開發者
- [文件](https://runapi.ai/zh-HK/docs/guides)
- [SDK](https://runapi.ai/zh-HK/sdk.md)
- [CLI](https://runapi.ai/zh-HK/cli.md)
- [MCP Server](https://runapi.ai/zh-HK/mcp.md)
- [x402](https://runapi.ai/zh-HK/x402.md)
### 指南
- [Claude Code 與 Cursor](https://runapi.ai/zh-HK/claude-code-vs-cursor.md)
- [Cursor API 設定](https://runapi.ai/zh-HK/cursor-api-setup.md)
- [RunAPI 與 OpenRouter](https://runapi.ai/zh-HK/openrouter-alternative.md)
### 公司
- [企業版](https://runapi.ai/zh-HK/contact.md)
- [聯絡](https://runapi.ai/zh-HK/contact.md)
### 法律
- [條款](https://runapi.ai/zh-HK/terms.md)
- [私隱](https://runapi.ai/zh-HK/privacy.md)
- [Site index for agents](https://runapi.ai/llms.txt)

Contact: contact@runapi.ai

## Structured data

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-HK",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-HK",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/zh-HK/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-HK",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-HK",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/zh-HKicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-HK",
    "@type": "SoftwareApplication",
    "name": "適用於 WorkBuddy 的 RunAPI Z Image",
    "applicationCategory": "DeveloperApplication",
    "description": "透過 RunAPI MCP 伺服器在 WorkBuddy 中使用阿里巴巴 Z Image 生成圖像。一個 API key，支援中英雙語文字渲染，從工作台快速文字生圖。",
    "url": "https://runapi.ai/zh-HK/workbuddy-z-image"
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-HK",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "我可以在 WorkBuddy 中使用 Z Image 嗎？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "可以。WorkBuddy 原生支援 MCP。將 RunAPI 作為 MCP server 指向 https://runapi.ai/mcp 並填入您的 RUNAPI_API_KEY，工作台 agent 便可呼叫文字轉圖像工具，並將 model 設為 z-image。"
        }
      },
      {
        "@type": "Question",
        "name": "使用 Z Image 需要單獨的 API 金鑰嗎？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "不需要。runapi MCP server 背後使用的同一個 RUNAPI_API_KEY 亦涵蓋 Z Image。所有 RunAPI 模型共用一個金鑰和一個點數餘額，無需為每個模型額外設定。"
        }
      },
      {
        "@type": "Question",
        "name": "Z Image 是非同步還是同步？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Z Image 採用非同步方式。工具呼叫會立即返回 task_id，WorkBuddy agent 會替您處理後續步驟——等待任務完成並在對話中返回圖像 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 server 上切換模型。"
        }
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-HK",
    "@type": "HowTo",
    "name": "如何透過 RunAPI 在 WorkBuddy 中使用 Z Image",
    "description": "在 WorkBuddy 中將 RunAPI 新增為 MCP 伺服器，然後提示工作台代理透過 RunAPI 文字生圖工具使用阿里巴巴 Z Image 生成圖像。",
    "step": [
      {
        "@type": "HowToStep",
        "position": 1,
        "name": "新增 RunAPI MCP 伺服器",
        "text": "在 WorkBuddy 中註冊一個名為 runapi 的 MCP 伺服器，透過 streamable HTTP 指向 https://runapi.ai/mcp，並在 Authorization 標頭中從 RUNAPI_API_KEY 讀取您的 key。若 RunAPI 已連接用於其他模型，請跳過此步驟——同一伺服器已公開 Z Image。",
        "url": "https://runapi.ai/zh-HK/workbuddy-z-image#how-step-1"
      },
      {
        "@type": "HowToStep",
        "position": 2,
        "name": "提示工作台代理",
        "text": "將提示詞貼入 WorkBuddy，並請其使用 runapi MCP 伺服器，將模型設為 z-image。Z Image 接受中文、英文或中英混合的提示詞，並能準確渲染兩種文字。",
        "url": "https://runapi.ai/zh-HK/workbuddy-z-image#how-step-2"
      },
      {
        "@type": "HowToStep",
        "position": 3,
        "name": "讓代理返回結果",
        "text": "WorkBuddy 呼叫 RunAPI 文字生圖工具，該工具會建立一個異步任務。代理會為您處理等待過程，並在任務完成後將已完成的圖像 URL 傳回對話中。",
        "url": "https://runapi.ai/zh-HK/workbuddy-z-image#how-step-3"
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-HK",
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "主頁",
        "item": "https://runapi.ai/zh-HK"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "適用於 WorkBuddy 的 RunAPI Z Image",
        "item": "https://runapi.ai/zh-HK/workbuddy-z-image"
      }
    ]
  }
]
```