公开版本与端点
| 模型 ID | 端点 | 起步价格 | 模型目录 |
|---|---|---|---|
z-image
|
/api/v1/z_image/text_to_image
|
$0.01 / 次调用 | 模型详情 |
验证
轮询，直到 Task 进入终态
POST /api/v1/z_image/text_to_image，并保存返回的 Task ID。
GET /api/v1/z_image/text_to_image/<task-id>，直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。配置
指南端点: /api/v1/z_image/text_to_image
export RUNAPI_API_KEY=your_api_key
curl -X POST https://runapi.ai/api/v1/z_image/text_to_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "z-image",
"prompt": "A cobalt vase on white marble.",
"aspect_ratio": "1:1"
}'
使用流程
三步开始使用
-
选择模型 ID
选择公开模型 ID，并查看其端点与当前起步价格。
-
配置 RunAPI
调用端点前设置 RUNAPI_API_KEY。
-
验证结果
对于异步端点，轮询同一端点，直到 Task 进入终态。
使用 Hermes Agent + Z Image 可以构建什么
-
影视与动画分镜
快速生成分镜画面，在创意讨论进行中就能迭代构图和机位。
-
电商商品可视化
为大批量商品目录生成材质和光线逼真的商品图。
-
教育插图
制作带双语标注的示意图和插图，用于教材、课程资料和培训内容。
为什么通过 RunAPI + Hermes Agent 使用 Z Image
-
1 个变体，一个 API 密钥
通过一个 RunAPI 连接选择可用的模型变体，无需更改现有集成。
-
清晰的用量价格
发送请求前查看目录中的当前价格，无需订阅或最低消费。
-
自动化任务流程
通过一致的任务流程提交任务、查询状态并收集异步结果，无需编写手动轮询代码。
Hermes Agent + Z Image 常见问题
可以在 Hermes Agent 中使用 Z Image 吗？
可以。只要 RunAPI 已在 Hermes Agent 中配置为提供方，同一个 API 密钥就能处理 Z Image 请求。调用本页列出的端点即可。
什么情况下应选择 Z Image 而不是其他图像模型？
Z Image 适合大批量生成和概念探索等最看重速度与成本的场景。需要最高保真度的最终图，建议与更高端的图像模型对比后再定。
通过 RunAPI 使用 Z Image 支持自定义 LoRA 吗？
不支持。RunAPI 端点提供的是不带自定义适配器的基础模型。如需微调效果，请在本地用开放权重加载你自己的 LoRA。
应该使用哪个模型 ID？
从版本表选择公开模型 ID。每个 ID 可使用的端点均显示在对应行。
本指南会配置聊天模型吗？
不会。该 Model Line 使用页面所示的端点流程，不会被描述为 Agent 聊天模型。