01
营销与广告视觉
使用 Z-Image 为产品发布、广告、落地页和社交活动生成不同视觉方向。标准化提示词和参考素材后，团队可以在不重建生成流程的情况下比较多个版本。
在 Playground 中试用 Z-Image
Image Generation
Alibaba
Z-Image API
阿里 Z-Image 是轻量文生图模型，出图速度快、单价低，支持 1:1、16:9、9:16 等多种画幅比例，适合海报设计、电商详情图、内容运营等需要高频批量出图的场景，所有请求均可通过 APIAny 的 OpenAI 兼容 API 直接调用，也可在模型详情页在线 Playground 中预览效果。
24 小时状态监控
近 24 小时成功率: 100%
模型：
价格： from 8 credits per request · ≈ $0.004-$0.008稳定性高，并在 APIAny 平台提供详细的使用记录。
z-image
46（建议：2,000）
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
模型概览
什么是 Z-Image API？
阿里 Z-Image 是轻量文生图模型，出图速度快、单价低，支持 1:1、16:9、9:16 等多种画幅比例，适合海报设计、电商详情图、内容运营等需要高频批量出图的场景，所有请求均可通过 APIAny 的 OpenAI 兼容 API 直接调用，也可在模型详情页在线 Playground 中预览效果。
先确定目标视觉效果、参考素材和交付格式，再围绕这些要求设计生成工作流。
APIAny 通过统一且有文档说明的 API 接口提供 Z-Image，并在同一页面展示实时价格、模型状态、请求示例和在线 Playground。团队可以先完成效果评估，再通过同一平台管理身份验证、用量记录和生产路由。
在 Playground 中试用 Z-Image
应用场景
Z-Image API 可以构建什么？
下面这些工作流展示了 Z-Image 在真实产品中的适用位置。可以先在 Playground 使用同一组输入进行测试，再与相关模型比较输出，并根据质量、延迟和预算要求选择合适的路由。
核心能力
Z-Image API 的主要功能
以下能力概括了评估 Z-Image 时需要关注的输入、输出和工作流特征。当前可用参数仍以本页实时 API Reference 为准。
/01
文本提示词输入
用文字描述目标结果或任务，并按文档中的 Z-Image API 请求格式发送。
/02
图像生成输出
根据所选 Z-Image 端点，从 API 返回或异步任务结果中获取生成图片。
/03
低延迟执行
在交互体验、快速迭代和响应时间敏感的任务中选择更快的 Z-Image 路由。
/04
高性价比扩展
结合实时价格和请求级用量记录运行更大规模的 Z-Image 任务并控制支出。
/05
多种画幅比例
为方形、竖版、横版或特定平台的 Z-Image 输出选择受支持的画幅。
APIAny 优势
为什么通过 APIAny 使用 Z-Image？
APIAny 将模型调用与从评估走向生产所需的运维能力放在一起，团队无需为每个供应商维护一套独立集成。
统一且稳定的 API 接口
使用 APIAny 密钥和明确的请求格式调用 Z-Image。上游路由或模型版本变化时，应用侧集成仍可保持稳定。
透明的用量与价格
请求前查看 Z-Image 的实时计费规则和 Playground 预估积分，请求完成后再核对请求级用量记录。
面向生产的路由控制
结合模型状态、通道健康、重试策略和用量日志，将 Z-Image 作为生产工作流的一部分稳定运行，而不只是用于单次演示。
接入方式
如何接入 Z-Image API
只需三步即可从 Playground 测试迁移到经过身份验证的生产请求。本页会同时提供模型标识、请求结构、价格和返回示例。 将生成任务作为异步媒体管线处理，保留持久任务状态、结果校验和资产交付环节。
- 01
创建 API 密钥
登录 APIAny，为项目创建 API 密钥，并只分配应用实际需要的模型范围和预算限制。
- 02
发送 Z-Image 请求
复制本页请求示例，将 model 字段设为选中的 Z-Image 版本，然后发送至文档所示的 APIAny 端点。
- 03
监控并持续优化
跟踪状态、延迟、积分和返回用量。在切换生产流量前，用同一类任务比较不同版本或相关模型。
FAQ
Z-Image API 常见问题
集中解答 Z-Image 的能力、应用场景、接入方式和版本选择问题。
什么是 Z-Image API？
阿里 Z-Image 是轻量文生图模型，出图速度快、单价低，支持 1:1、16:9、9:16 等多种画幅比例，适合海报设计、电商详情图、内容运营等需要高频批量出图的场景，所有请求均可通过 APIAny 的 OpenAI 兼容 API 直接调用，也可在模型详情页在线 Playground 中预览效果。 APIAny 让该模型可以通过带身份验证的 API 调用，并在同一页面提供实时价格、状态信息、请求示例和在线 Playground。
Z-Image API 适合构建哪些应用？
Z-Image 的常见工作流包括：营销与广告视觉, 商品与目录内容, 快速创意迭代。具体是否适合，取决于产品要求的输入格式、输出质量、响应延迟和成本。
如何通过 APIAny 调用 Z-Image？
创建 APIAny 密钥，使用本页文档中的端点，并将请求的 model 字段设为选中的 Z-Image 版本。正式接入代码前，可以先用 Playground 生成一份可运行的请求。
应该如何选择 Z-Image 的版本？
根据本页展示的价格、支持参数以及 文本提示词输入, 图像生成输出, 低延迟执行 等能力比较不同版本。建议先用一条有代表性的生产输入完成测试，再确定默认路由。
API 说明
通过标准 REST API 调用该模型。使用 API Key 鉴权后，在下方选择端点即可查看其参数与示例。
鉴权
每个请求都需要在 Authorization 头中携带 Bearer 令牌。请在控制台创建 API Key。
Authorization: Bearer YOUR_API_KEYPOST
https://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 小时。
