POST https://api.goenhance.ai/api/v1/images/generations 並設定 model: z-image 來生成圖片。Z-Image 每張圖片的固定費用為 $0.004（0.2 個代幣），是 GoEnhance 圖片目錄中單張價格最低的方案，並會回傳一個非同步的 img_uuid 以供輪詢或回調使用。用於低成本文字生成圖片的 Z-Image API
透過
建立 API 金鑰
專注於文字生成圖片的 API
僅使用 <code>z-image</code> 請求架構所支援的欄位。
Z-Image API 參數與功能
精確模型 ID
將 <code>model</code> 精確設定為 <code>z-image</code>。頁面產品名稱維持為 Z-Image。
必填提示詞
提供一個 1 到 2000 個字元且非空的 <code>prompt</code>，以描述要生成的圖片。
七種長寬比
從 <code>1:1</code>、<code>2:3</code>、<code>3:2</code>、<code>4:3</code>、<code>3:4</code>、<code>16:9</code> 或 <code>9:16</code> 中選擇一個。若省略 <code>ratio</code>，將使用模型預設值。
選用回調
將 <code>custom_callback_url</code> 設定為公開的 HTTPS 端點，以接收處理狀態、成功與失敗的更新。
僅限文字生成圖片
此路徑不接受參考圖片或編輯輸入。當您的工作流程需要參考驅動的編輯時，請使用其他 GoEnhance 圖片模型。
架構驗證
不支援的比例會在扣除代幣前的架構驗證階段被拒絕。Z-Image 不支援 <code>auto</code> 或 <code>21:9</code> 比例。
單一費率讓低成本 AI 圖像生成 API 的預算計算變得輕而易舉。
簡單、統一的 Z-Image 定價
每張圖片 $0.004
每次成功的生成費用精確為每張圖片 $0.004。
每張圖片 0.2 個代幣
相同的費用為 0.2 個代幣。GoEnhance 代幣定價為 500 個代幣 $10 美元，即每個代幣 $0.02 美元。
無解析度或用量分級
Z-Image 採用單一固定價格。請求中不提供解析度參數，且公開費率不會因用量而改變。
透過三個步驟整合 Z-Image
1
1. 提交提示詞
發送已驗證的 POST 請求至
https://api.goenhance.ai/api/v1/images/generations，並包含 {"model":"z-image","prompt":"...","ratio":"16:9"}。 2
2. 儲存 img_uuid
成功提交後會回傳
data.img_uuid。請將其與您的應用程式記錄一起儲存，無需同步等待圖像生成。 3
3. 輪詢或接收回調
輪詢
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=..., 或註冊 custom_callback_url 以處理處理中、成功及失敗狀態。在需要可預測的單張圖像成本和精簡請求格式的情況下，使用 Z-Image。
低成本文字轉圖像 API 的適用場景
內容插圖
根據文字提示為文章、指南和編輯工作流程生成視覺概念。
產品概念設計
在生產前為產品、包裝、環境或活動主題建立初步的視覺方向。
廣告創意探索
產生獨特的提示驅動概念以供創意審核，同時追蹤每張生成圖像的固定成本。
在地化視覺管線
針對區域主題和格式調整提示詞，同時選擇支援的橫向、縱向或方形比例。
背景生成
為不需要參考編輯的後續設計工作流程生成場景背景和氛圍素材。
高量原型製作
使用 0.004 美元的統一費率來估算原型生成成本，無需進行解析度或量級計算。
為評估低成本文字生成圖像 API 的開發者提供的整合詳情。