Alibaba · 圖像

OpenClaw x Z Image

Z Image 是 Alibaba 針對速度優化的文字生成圖片模型,生成結果非常快。透過 RunAPI,它與所有 Alibaba 模型共用相同的 API 結構及計費方式。

1 variants 由 $0.01 / 次請求 可商用

Prerequisite: npx runapi mcp install

Prompt

Prompt 模型

任務合適時使用 z-image:z-image。

You have access to RunAPI task tools for Z Image.

Available Z Image models:
- z-image: z-image
  endpoints: /api/v1/z_image/text_to_image
  request fields: model, prompt, aspect_ratio

Use the model ID and endpoint that match the user's request.
Example prompt: 生成一張簡潔的產品照:白色波鞋放在漸變背景上,影樓燈光。
/api/v1/z_image/text_to_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/z_image/text_to_image,並儲存回傳的 Task ID。
GET /api/v1/z_image/text_to_image/<task-id>,直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。

公開版本與端點

模型 ID 端點 起始價格 模型目錄
z-image
/api/v1/z_image/text_to_image
$0.01 / 次請求 模型詳情

驗證

輪詢,直到 Task 進入終態

POST /api/v1/z_image/text_to_image,並儲存回傳的 Task ID。
GET /api/v1/z_image/text_to_image/<task-id>,直到狀態為 completed 或 failed。
確認 completed 回應包含 API 參考中記載的端點專屬輸出。

設定

指南端點: /api/v1/z_image/text_to_image

export RUNAPI_API_KEY=your_api_key

curl -X POST https://runapi.ai/api/v1/z_image/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "z-image",
  "prompt": "A cobalt vase on white marble.",
  "aspect_ratio": "1:1"
}'
使用流程

三步開始使用

  1. 選擇模型 ID

    選擇公開模型 ID,並查看其端點與目前起始價格。

  2. 設定 RunAPI

    呼叫端點前設定 RUNAPI_API_KEY。

  3. 驗證結果

    對非同步端點輪詢同一路徑,直到 Task 進入終態。

使用 OpenClaw + Z Image 可以建立甚麼

  • 概念探索與快速原型

    以較低成本快速生成大量視覺概念,先確定方向,再用逼真度更高的模型產出最終圖。

  • 中英雙語營銷活動

    在同一張圖中準確呈現中文和英文文字,適合跨境電商和多語社交媒體。

  • 服裝與商品攝影樣圖

    生成材質和光線可信的寫實商品樣圖,速度足以支援構圖迭代。

為甚麼透過 RunAPI + OpenClaw 使用 Z Image

  • 1 個變體,一個 API 金鑰

    透過一個 RunAPI 連線選擇可用的模型變體,無需更改現有整合。

  • 清晰的用量價格

    發送請求前查看目錄中的目前價格,無需訂閱或最低消費。

  • 自動化工作流程

    透過一致的工作流程提交工作、查詢狀態並收集非同步結果,無需編寫手動輪詢程式碼。

OpenClaw + Z Image 常見問題

可以在 OpenClaw 中使用 Z Image 嗎?

可以。只要 RunAPI 已在 OpenClaw 中設定為供應商,同一組 API 金鑰就能處理 Z Image 請求。調用本頁列出的端點即可。

什麼情況下應該選擇 Z Image 而不是其他圖像模型?

Z Image 適合大量生成和概念探索等最重視速度與成本的情境。需要最高逼真度的最終圖,建議先和更高階的圖像模型比較再決定。

Z Image 能在同一張圖裡同時呈現中文和英文嗎?

可以。提示詞中可以混用兩種語言,模型會同時處理兩種文字的排版,適合多語標籤和營銷素材。

應該使用哪個模型 ID?

從版本表選擇公開模型 ID。每個 ID 可用的端點均列於相應資料列。

本指南會設定聊天模型嗎?

不會。此 Model Line 使用頁面所示的端點流程,不會被描述為 Agent 聊天模型。

透過 OpenClaw 開始使用 Z Image

正在與團隊一起建立?

我們可以協助企業設定、整合和技術問題。

聯絡我們