用于低成本文本生成图像的 Z-Image API

通过 POST https://api.goenhance.ai/api/v1/images/generations 并设置 model: z-image 来生成图像。Z-Image 每张图像的固定成本为 0.004 美元(0.2 个代币)——这是 GoEnhance 图像目录中每张图像价格最低的——并返回一个异步 img_uuid 用于轮询或回调。
创建 API 密钥
一个电影感创意工作室场景,展示 Z-Image 文本生成图像功能

专注的文本生成图像 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

1. 提交提示词

发送经过身份验证的 POST 请求至 https://api.goenhance.ai/api/v1/images/generations,并包含 {"model":"z-image","prompt":"...","ratio":"16:9"}
2. 保存 img_uuid
2

2. 保存 img_uuid

提交成功后会返回 data.img_uuid。请将其与您的应用程序记录一起存储,无需同步等待图像生成。
3. 轮询或接收回调
3

3. 轮询或接收回调

轮询 GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=..., 或注册 custom_callback_url 以处理处理中、成功和失败状态。
在需要可预测的单张图像成本和紧凑请求格式的情况下使用 Z-Image。

低成本文本转图像 API 的适用场景

内容插图

根据文本提示为文章、指南和编辑工作流生成视觉概念。

产品概念化

在生产前为产品、包装、环境或活动主题创建初步的视觉方向。

广告创意探索

生成独特的提示词驱动概念以供创意评审,同时跟踪每张生成图像的固定成本。

本地化视觉流水线

针对区域主题和格式调整提示词,同时选择支持的横向、纵向或方形比例。

背景生成

为不需要参考编辑的下游设计工作流生成场景背景和氛围素材。

大批量原型设计

使用 0.004 美元的统一费率来估算原型生成成本,无需进行分辨率或批量层级计算。
为评估低成本文本生成图像 API 的开发者提供的集成详情。

Z-Image API 常见问题解答

开始使用 Z-Image API 进行构建