Z-Image API 适合构建哪些应用？

Z-Image 的常见工作流包括：营销与广告视觉, 商品与目录内容, 快速创意迭代。具体是否适合，取决于产品要求的输入格式、输出质量、响应延迟和成本。

如何通过 APIAny 调用 Z-Image？

创建 APIAny 密钥，使用本页文档中的端点，并将请求的 model 字段设为选中的 Z-Image 版本。正式接入代码前，可以先用 Playground 生成一份可运行的请求。

应该如何选择 Z-Image 的版本？

根据本页展示的价格、支持参数以及文本提示词输入, 图像生成输出, 低延迟执行等能力比较不同版本。建议先用一条有代表性的生产输入完成测试，再确定默认路由。

Image Generation

Alibaba

Z-Image API

Q: 应该如何选择 Z-Image 的版本？

根据本页展示的价格、支持参数以及 文本提示词输入, 图像生成输出, 低延迟执行 等能力比较不同版本。建议先用一条有代表性的生产输入完成测试，再确定默认路由。

阿里 Z-Image 是轻量文生图模型，出图速度快、单价低，支持 1:1、16:9、9:16 等多种画幅比例，适合海报设计、电商详情图、内容运营等需要高频批量出图的场景，所有请求均可通过 APIAny 的 OpenAI 兼容 API 直接调用，也可在模型详情页在线 Playground 中预览效果。

24 小时状态监控

近 24 小时成功率: 100%

模型：

z-image

价格： from 8 credits per request · ≈ $0.004-$0.008稳定性高，并在 APIAny 平台提供详细的使用记录。

示例

模型

z-image

提示词46（建议：2,000）

Aspect ratio

Output aspect ratio. Custom WxH pixel sizes remain accepted in JSON mode when supported upstream.

美元估算 $0.004-$0.008：最高充值套餐按 $1 = 2,000 积分计算；入门套餐按 $1 = 1,000 积分计算。

预览

无运行中的任务

IMAGE结果预览

历史记录

保存在此浏览器本地

0 个运行中 · 0 个已完成

你的生成历史将显示在这里

计费规则

• 所示价格按后台中的模型配置进行计费。
• 调用将消耗当前账户的积分并写入使用记录。
• 媒体任务采用与公开 API 相同的异步处理流程。

价格

模型 ID

类型

计费项

价格

z-image

图像生成

默认

8 积分每次请求 · ≈ $0.004-$0.008

模型 IDz-image

类型图像生成

计费项默认

价格8 积分每次请求 · ≈ $0.004-$0.008

API 说明

通过标准 REST API 调用该模型。使用 API Key 鉴权后，在下方选择端点即可查看其参数与示例。

鉴权

每个请求都需要在 Authorization 头中携带 Bearer 令牌。请在控制台创建 API Key。

Authorization: Bearer YOUR_API_KEY

POSThttps://apiany.ai/v1/images/generations

请求参数

参数	类型	必填	说明
`model`	字符串	必填	要调用的模型标识，使用该模型的 ID。
`prompt`	字符串	必填	描述你想生成内容的文本提示词。
`size`	字符串	可选	Output aspect ratio. Custom WxH pixel sizes remain accepted in JSON mode when supported upstream. · 可选值: 1:1, 16:9, 9:16, 4:3, 3:4 · 默认: 1:1
`callback_url`	字符串	可选	可选的回调地址，异步任务完成后会被调用。

请求示例

curl "https://apiany.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "z-image",
  "prompt": "为 APIAny.AI 生成一张简洁的产品主视觉图：现代 API 网关控制台，明亮的影棚灯光",
  "size": "1:1"
}'

响应示例

{
  "task_id": "task_abc123",
  "status": "pending",
  "poll_url": "/v1/tasks/task_abc123",
  "request_id": "req_abc123",
  "credits": {
    "reserved": 1000
  }
}

该端点为异步调用：请求后会立即返回 task_id。请轮询任务状态查询端点，直到 status 变为 succeeded 后再读取 result。生成的媒体链接有效期为 24 小时。