公開版本與端點
| 模型 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"
}'
使用流程
三步開始使用
-
選擇模型 ID
選擇公開模型 ID，並查看其端點與目前起始價格。
-
設定 RunAPI
呼叫端點前設定 RUNAPI_API_KEY。
-
驗證結果
對非同步端點輪詢同一路徑，直到 Task 進入終態。
使用 Hermes Agent + Z Image 可以建立甚麼
-
影視與動畫分鏡
快速生成分鏡畫面，在創意討論進行中就能迭代構圖和鏡位。
-
電商商品視覺化
為大量商品目錄生成材質和光線逼真的商品圖。
-
教育插圖
製作附雙語標註的示意圖和插圖，用於教科書、課程教材和培訓內容。
為甚麼透過 RunAPI + Hermes Agent 使用 Z Image
-
1 個變體，一個 API 金鑰
透過一個 RunAPI 連線選擇可用的模型變體，無需更改現有整合。
-
清晰的用量價格
發送請求前查看目錄中的目前價格，無需訂閱或最低消費。
-
自動化工作流程
透過一致的工作流程提交工作、查詢狀態並收集非同步結果，無需編寫手動輪詢程式碼。
Hermes Agent + Z Image 常見問題
可以在 Hermes Agent 中使用 Z Image 嗎？
可以。只要 RunAPI 已在 Hermes Agent 中設定為供應商，同一組 API 金鑰就能處理 Z Image 請求。調用本頁列出的端點即可。
什麼情況下應該選擇 Z Image 而不是其他圖像模型？
Z Image 適合大量生成和概念探索等最重視速度與成本的情境。需要最高逼真度的最終圖，建議先和更高階的圖像模型比較再決定。
透過 RunAPI 使用 Z Image 支援自訂 LoRA 嗎？
不支援。RunAPI 端點提供的是不含自訂轉接器的基礎模型。如需微調效果，請在本地用開放權重載入你自己的 LoRA。
應該使用哪個模型 ID？
從版本表選擇公開模型 ID。每個 ID 可用的端點均列於相應資料列。
本指南會設定聊天模型嗎？
不會。此 Model Line 使用頁面所示的端點流程，不會被描述為 Agent 聊天模型。