---
title: 在 WorkBuddy 中通过 RunAPI 使用 Z Image — 图像 API 指南 | RunAPI
description: 通过 RunAPI MCP 服务器在 WorkBuddy 中使用阿里巴巴 Z Image 生成图像。一个 API Key，中英双语文字渲染，在工作台内快速完成文生图。
url: https://runapi.ai/zh-CN/workbuddy-z-image.md
canonical: https://runapi.ai/zh-CN/workbuddy-z-image
locale: zh-CN
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-CN/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-CN/login)
- [阅读文档](https://runapi.ai/zh-CN/docs/guides)

一个 MCP 服务器 · 一个 API Key · 异步任务由智能体代办

### Prompt

```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 环境变量读取密钥。如果你已为其他模型连接过 RunAPI，可跳过此步——同一个服务器就包含 Z Image。 `url: https://runapi.ai/mcp`
2. **向工作台智能体下达提示词** - 把提示词粘贴到 WorkBuddy，让它使用 runapi MCP 服务器并将 model 设为 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 服务器上的工具形式出现，工作台智能体在任务过程中即可随时生成图像，无需离开对话。

## Z Image 使用场景

- **概念探索与快速原型** - 让 WorkBuddy 一次给出十几个视觉方向，几秒内就能拿到结果，每张只需几厘钱——先大范围探索，再用更昂贵的模型完成最终输出。
- **双语营销活动** - 在单张图像中准确渲染中英文文字，直接在工作台内产出跨境电商和多语言社交媒体所需的营销视觉内容。
- **时尚与产品摄影效果图** - 以准确的材质纹理和光线效果生成写实产品摄影效果图，速度快到可以边和智能体打磨需求边实时迭代构图。

## Z Image + WorkBuddy 常见问题

### 可以在 WorkBuddy 中使用 Z Image 吗？

可以。WorkBuddy 原生支持 MCP。将 RunAPI 添加为指向 https://runapi.ai/mcp 的 MCP 服务器并填入 RUNAPI_API_KEY，工作台智能体就能调用文生图工具，将 model 设为 z-image。

### Z Image 需要单独的 API Key 吗？

不需要。runapi MCP 服务器背后的同一个 RUNAPI_API_KEY 也覆盖 Z Image。所有 RunAPI 模型共享一个密钥和一个点数余额，无需为单个模型做额外配置。

### 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/zh-CN/workbuddy.md) - 还没连接？从 WorkBuddy 的 RunAPI MCP 配置指南开始。
- [Z Image 模型 →](https://runapi.ai/zh-CN/models/z-image.md) - 查看所有 Z Image 变体、价格和 API 文档。

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

获取免费 RunAPI Key，在 WorkBuddy 中添加 MCP 服务器，直接在工作台内生成支持双语文字渲染的图像。

[浏览模型 →](https://runapi.ai/zh-CN/models.md)

---

## More from RunAPI

- [Home](https://runapi.ai/zh-CN/.md)
### 产品
- [模型目录](https://runapi.ai/zh-CN/models.md)
- [定价](https://runapi.ai/zh-CN/pricing.md)
- [提供方](https://runapi.ai/zh-CN/models#all-models)
### 开发者
- [文档](https://runapi.ai/zh-CN/docs/guides)
- [SDK](https://runapi.ai/zh-CN/sdk.md)
- [CLI](https://runapi.ai/zh-CN/cli.md)
- [MCP Server](https://runapi.ai/zh-CN/mcp.md)
- [x402](https://runapi.ai/zh-CN/x402.md)
### 指南
- [Claude Code 与 Cursor](https://runapi.ai/zh-CN/claude-code-vs-cursor.md)
- [Cursor API 设置](https://runapi.ai/zh-CN/cursor-api-setup.md)
- [RunAPI 与 OpenRouter](https://runapi.ai/zh-CN/openrouter-alternative.md)
### 公司
- [企业版](https://runapi.ai/zh-CN/contact.md)
- [联系](https://runapi.ai/zh-CN/contact.md)
### 法律
- [服务条款](https://runapi.ai/zh-CN/terms.md)
- [隐私政策](https://runapi.ai/zh-CN/privacy.md)
- [Site index for agents](https://runapi.ai/llms.txt)

Contact: contact@runapi.ai

## Structured data

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-CN",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/zh-CN/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-CN",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/zh-CNicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "SoftwareApplication",
    "name": "适用于 WorkBuddy 的 RunAPI Z Image",
    "applicationCategory": "DeveloperApplication",
    "description": "通过 RunAPI MCP 服务器在 WorkBuddy 中使用阿里巴巴 Z Image 生成图像。一个 API Key，中英双语文字渲染，在工作台内快速完成文生图。",
    "url": "https://runapi.ai/zh-CN/workbuddy-z-image"
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "可以在 WorkBuddy 中使用 Z Image 吗？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "可以。WorkBuddy 原生支持 MCP。将 RunAPI 添加为指向 https://runapi.ai/mcp 的 MCP 服务器并填入 RUNAPI_API_KEY，工作台智能体就能调用文生图工具，将 model 设为 z-image。"
        }
      },
      {
        "@type": "Question",
        "name": "Z Image 需要单独的 API Key 吗？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "不需要。runapi MCP 服务器背后的同一个 RUNAPI_API_KEY 也覆盖 Z Image。所有 RunAPI 模型共享一个密钥和一个点数余额，无需为单个模型做额外配置。"
        }
      },
      {
        "@type": "Question",
        "name": "Z Image 是异步还是同步的？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "异步。工具调用会立即返回 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": "zh-CN",
    "@type": "HowTo",
    "name": "如何在 WorkBuddy 中通过 RunAPI 使用 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 环境变量读取密钥。如果你已为其他模型连接过 RunAPI，可跳过此步——同一个服务器就包含 Z Image。",
        "url": "https://runapi.ai/zh-CN/workbuddy-z-image#how-step-1"
      },
      {
        "@type": "HowToStep",
        "position": 2,
        "name": "向工作台智能体下达提示词",
        "text": "把提示词粘贴到 WorkBuddy，让它使用 runapi MCP 服务器并将 model 设为 z-image。Z Image 支持中文、英文或中英混合的提示词，两种文字都能精准渲染。",
        "url": "https://runapi.ai/zh-CN/workbuddy-z-image#how-step-2"
      },
      {
        "@type": "HowToStep",
        "position": 3,
        "name": "由智能体交回结果",
        "text": "WorkBuddy 调用 RunAPI 文生图工具，工具会创建一个异步任务。智能体替你处理等待过程，任务完成后把生成的图像 URL 直接返回到对话中。",
        "url": "https://runapi.ai/zh-CN/workbuddy-z-image#how-step-3"
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "首页",
        "item": "https://runapi.ai/zh-CN"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "适用于 WorkBuddy 的 RunAPI Z Image",
        "item": "https://runapi.ai/zh-CN/workbuddy-z-image"
      }
    ]
  }
]
```