用于低成本文本生成图像的 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

提示词优先生成

使用必需的 prompt 字段(1–2000 个字符)来描述图像。当前的统一端点要求 model: z-image。
一个富有想象力的单场景视觉图,展示详细的提示词转化为成品图像的过程

每张图像 0.004 美元的统一价格

每次 Z-Image 生成消耗 0.2 个代币,相当于 0.004 美元。该模型没有分辨率或数量层级,这使得成本估算非常简单。
一个精致的单场景生产设置,代表高效的大规模图像生成
仅使用 <code>z-image</code> 请求架构支持的字段。

Z-Image API 参数与功能

精确模型 ID

将 model 设置为 z-image。页面产品名称保持为 Z-Image。

必需的提示词

提供一个 1 到 2000 个字符的非空 prompt,用于描述要生成的图像。

七种长宽比

从 1:1、2:3、3:2、4:3、3:4、16:9 或 9:16 中选择一个。省略 ratio 则使用模型默认值。

可选回调

将 custom_callback_url 设置为公共 HTTPS 端点,以接收处理进度、成功和失败的更新。

仅限文本生成图像

此路由不接受参考图像或编辑输入。当您的工作流需要基于参考的编辑时,请使用其他 GoEnhance 图像模型。

架构验证

不支持的比例会在扣除代币前的架构验证阶段被拒绝。Z-Image 没有 auto 或 21:9 比例。
单一费率让低成本 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 以处理处理中、成功和失败状态。
创建 API 密钥
在需要可预测的单张图像成本和紧凑请求格式的情况下使用 Z-Image。

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

内容插图

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

产品概念化

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

广告创意探索

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

本地化视觉流水线

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

背景生成

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

大批量原型设计

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

Z-Image API 常见问题解答

我应该为 Z-Image API 使用哪个端点?

使用 POST https://api.goenhance.ai/api/v1/images/generations 并将 model 设置为 z-image。虽然存在旧版 POST /api/v1/z-image 路由,但统一的图像端点是当前记录在案的集成路径。

为什么有些搜索会使用 Turbo 这个名称?

阿里巴巴/通义将上游模型称为 Z-Image Turbo。在 GoEnhance 产品目录和 API 文档中,产品名称为 Z-Image,确切的模型 ID 为 z-image。

生成一张 Z-Image 需要多少钱?

统一价格为每张图像 0.004 美元,相当于 0.2 个 Token。此模型没有分辨率层级或批量层级。

Z-Image 支持哪些比例?

正好七种:1:1、2:3、3:2、4:3、3:4、16:9 和 9:16。该路由不支持 auto 或 21:9。

我可以发送参考图像或编辑现有图像吗?

不能。此路由上的 Z-Image 仅支持文本转图像,不接受参考图像、图像转图像输入或编辑请求。请选择其他 GoEnhance 模型进行参考驱动的编辑。

我可以在一次调用中请求分辨率或多张图像吗?

不能。Z-Image 架构没有分辨率字段,也没有 n 或批量计数参数。当您需要多个输出时,请提交单独的生成请求。

异步 Z-Image 任务如何完成?

生成响应会返回 img_uuid。轮询 /api/v1/jobs/detail?img_uuid=... 或提供 custom_callback_url 以接收状态更改。

GoEnhance 与阿里巴巴有隶属关系吗?

注:Z-Image 源自阿里巴巴通义/Qwen 组织。GoEnhance 开放 API 是一个独立的第三方平台,与阿里巴巴无关联,也未获得其认可。

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

Z-Image API:0.004 美元文本生成图像 | GoEnhance