使用指南
Qwen Image 2.0 Pro 电商产品摄影：hiapi API 工作流
TL;DR
- 这是什么：一套真实的电商生产工作流，使用 hiapi API 上的 qwen-image-2.0-pro —— 一张主视觉产品图、一张带渲染促销文案的促销横幅，以及一张变体网格图，全部由本页展示的精确提示词和请求生成。
- 产品工作为何选 Pro 档：更精细的逼真细节、更可靠的图中文字渲染（真实的促销文案，而不是乱码文字），以及对详细提示词更好的语义遵循 —— 价格为 $0.107/图，最高 2048×2048，而基础 qwen-image-2.0 档为 $0.025/图（定价）。
- 经验证的 API 事实：输入 schema 接收
prompt和一个size字符串（"2048*2048"、"2688*1536"、"2368*1728"、"1728*2368"或"1536*2688"）—— 没有aspect_ratio字段，且仅支持文生图（没有image_input/ i2i）。 - 工作流：通过
/v1/tasks并行提交每个素材的一个任务，逐个轮询直至完成，立即下载output[0].url（会过期），然后在任何内容交付前重新检查渲染出的文字。
为什么选择 qwen-image-2.0-pro 做产品摄影
一个产品列表通常需要三种不同的素材，而且它们看起来必须像是同一次拍摄：用于列表页的干净主视觉图、用于营销活动的带真实促销文案的促销横幅，以及用于多 SKU 目录页的变体网格图。这比单张主视觉图的工作面更宽，而 Pro 档正是在这里相比基础版 qwen-image-2.0 体现出其价格溢价：
- 更精细的逼真细节。玻璃、拉丝金属、石材 —— 这类镜面高光细节在目录缩略图尺寸下读起来是“真实照片”而非“渲染图”。
- 更可靠的文字渲染。促销横幅和包装需要精确的文案落入画面，拼写正确、字距干净。Pro 档针对此做了调优；本页下方的横幅就是一个未经编辑的示例。
- 更好的语义遵循。本页的三个提示词在表面、光线和布局上都长而具体 —— Pro 档完全遵循了所有这些要求，包括其中两张图上的“无文字”指令。
代价是成本：$0.107/图，而基础档为 $0.025（实时验证定价，2026-08）。对于单张主视觉图，这只是舍入误差。对于几百个 SKU 的目录，这就是真金白银 —— 如何在这两者之间分配工作，请见下方 Pro 与基础档对比。
设置
你只需要一个 hiapi API key，别的什么都不需要 —— 无需 SDK：
export HIAPI_API_KEY="sk-..."
qwen-image-2.0-pro 通过统一的异步任务端点运行：POST https://api.hiapi.ai/v1/tasks 立即返回一个 taskId，然后你轮询 GET /v1/tasks/{taskId} 直到它完成。
每个产品列表都需要的三种素材
1. 主视觉产品图
列表页用图：单一产品、居中、干净背景，没有任何东西争夺注意力。完整提示词，与提交时完全一致：
Studio product photograph of a single amber glass skincare dropper bottle with a blank matte white label, standing centered on a round travertine stone pedestal, seamless warm off-white studio background, soft diffused key light from the upper left, a subtle soft shadow falling to the right, hyper-detailed macro texture on the glass and brushed-metal dropper cap, photorealistic, catalog-ready e-commerce hero shot, no text, no logos, no props
2. 带渲染文字的促销横幅
这正是 Pro 档文字渲染发挥作用的场景。提示词要求将两行具体的促销文案放在特定角落 —— 没有占位文字，没有“在此处输入你的文字”：
Flat-lay e-commerce promo banner photograph: three amber glass skincare dropper bottles arranged diagonally on a warm terracotta backdrop with dried eucalyptus sprigs, soft overhead studio lighting with gentle shadows, in the upper right corner bold clean white sans-serif text reading SUMMER GLOW SALE, directly beneath it smaller white text reading SAVE 20% TODAY, no other text anywhere, photorealistic commercial photography, sharp focus
根据 hiapi 的内容操作手册，渲染文字绝不能在未经人工通读的情况下交付 —— AI 文字渲染可靠但并非万无一失，偶尔的掉字或字距失误只有在检查时才会暴露。这张横幅在发布到本页之前已逐字符对照提示词进行了核对。
3. 变体网格图
对于列出每个规格或香型的目录页，平铺网格图能让每个变体在视觉上保持一致：
Overhead flat-lay product grid photograph of six amber glass skincare dropper bottles with blank matte white labels, arranged in two neat rows of three on a light grey seamless studio background, even soft diffused lighting with minimal shadows, consistent spacing between bottles, photorealistic catalog variant-grid layout, no text, no logos
注意这三张图上的空白标签 —— 按 SKU 的标签（品牌名、香型、规格）是在小表面上的小号文字，这比横幅标题是更难的渲染目标。实用的模式是：生成带空白标签的瓶子，然后在后期合成标签文字。而且当促销价格变化时，这样更新也更快。
输入 schema，已对照实时 API 验证
qwen-image-2.0-pro 的 /v1/tasks schema 比看起来更严格 —— 没有 aspect_ratio，没有 n，也完全没有图像输入字段：
| 字段 | 类型 | 必填 | 取值 |
|---|---|---|---|
prompt |
string | ✅ | 你的镜头描述 |
size |
string | ✅ | 2048*2048、2688*1536、2368*1728、1728*2368、1536*2688 |
negative_prompt |
string | 可选 | 要排除的内容 |
seed |
integer | 可选 | 用于可复现性 |
watermark |
boolean | 可选 | |
prompt_extend |
boolean | 可选 | 让模型扩展简短的提示词 |
对于任何从其他 hiapi 图像模型移植请求的人来说，有两点值得注意：这里没有 aspect_ratio 参数（直接使用 size），而且此模型仅支持文生图 —— 没有参考图字段，所以你无法给它一张你实际产品的照片并要求生成变体。仅靠提示词控制是全部手段。完整的请求/响应结构和错误示例见 API 教程；本页聚焦电商使用场景。
批量脚本：三种素材，一个提交循环
由于 /v1/tasks 是异步的，生成主视觉图、横幅和网格图只是三次提交加三次轮询 —— 无需串行等待：
import time
import requests
API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"}
def submit(prompt: str, size: str) -> str:
r = requests.post(API, headers=HEADERS, json={
"model": "qwen-image-2.0-pro",
"input": {"prompt": prompt, "size": size},
}, timeout=60)
task_id = (r.json().get("data") or {}).get("taskId")
if not task_id:
raise RuntimeError(f"submit failed: {r.text}")
return task_id
def wait(task_id: str, timeout_s: int = 600) -> dict:
deadline = time.time() + timeout_s
while time.time() < deadline:
task = requests.get(f"{API}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
if task["status"] == "success":
return task
if task["status"] == "fail":
raise RuntimeError(f"task failed: {task.get('error')}")
time.sleep(5)
raise TimeoutError(task_id)
jobs = [
("hero-packshot", "Studio product photograph of ...", "2048*2048"),
("promo-banner", "Flat-lay e-commerce promo banner ...", "2688*1536"),
("variant-grid", "Overhead flat-lay product grid ...", "2368*1728"),
]
task_ids = {name: submit(prompt, size) for name, prompt, size in jobs} # fan out
for name, task_id in task_ids.items(): # collect
result = wait(task_id)
url = result["output"][0]["url"] # expires — download immediately
open(f"{name}.png", "wb").write(requests.get(url, timeout=120).content)
测试中，每张约 2000px 范围的渲染耗时大约一分钟；在高峰负载下，每张图请预留几分钟，再将其视为超时。
Pro 与基础档：该用哪个
两个档位共享相同的 prompt + size schema，因此在它们之间切换只需改一行 model 字段：
| qwen-image-2.0（基础） | qwen-image-2.0-pro | |
|---|---|---|
| 价格 | $0.025/图 | $0.107/图 |
| 最大尺寸 | 2048×2048 | 2048×2048 |
| 文字渲染 | 良好 | 更强 —— 促销文案的默认选择 |
| 逼真细节 | 良好 | 更精细 —— 主视觉图的默认选择 |
| 最适合 | 提示词探索、大批量草稿、内部效果图 | 最终主视觉/横幅素材、任何带渲染文字的内容 |
真实目录的实用分配：在基础档上起草构图，此时一轮迭代成本很低，然后在 Pro 档上重新渲染入围的优胜者，用于实际交付的素材。基础档工作流 —— 相同的任务 API、相同的提示词风格 —— 见 使用 qwen-image-2.0 生成电商产品图。
产品照片提示词技巧
在这三次渲染中始终有效的做法：
- 指明表面和光线，而不只是主体。“洞石基座”、“来自左上方的柔和漫射主光”对逼真度的贡献比“专业”或“高质量”这类形容词更大。
- 在不应有文字的图上声明“无文字、无标志”。如果不说明，产品照片提示词偶尔会带上杂散的标签痕迹；明确指出负面约束能让产品图保持干净。
- 为横幅用等价的引号语言写出精确文案。“加粗干净的白色无衬线文字，内容为 SUMMER GLOW SALE”准确渲染；而更含糊的“一些促销文字”则会把措辞交给运气。
- 在包装上要求空白标签，而不是极小的品牌文字。小面积表面文字是任何图像模型上最难的渲染目标 —— 改为在后期合成。
FAQ
我可以把实际产品的照片喂给 qwen-image-2.0-pro 来生成变体吗？ 不可以 —— 此模型仅支持文生图，其 schema 中没有图像输入字段。对于图生图工作流，你需要 hiapi 上另一个明确支持 i2i 的模型。
渲染出的文字可靠到无需检查就能交付吗？ 不 —— 它可靠，但并不完美。发布前对照提示词逐字符阅读，出现罕见失误时重新生成。请见上方促销横幅下的说明。
列表主视觉图和横幅应该用什么尺寸？
正方形 2048*2048 覆盖大多数市场平台的列表要求。对于宽幅促销横幅或主视觉轮播，2688*1536 或 2368*1728（横版/竖版）更接近常见网页横幅比例，无需后期裁剪。
Pro 档支持批量折扣吗？ 不支持 —— 定价为每张图固定 $0.107，与量无关；成本杠杆在于你生成多少张图，而不是批量费率。
总结
对于电商目录，qwen-image-2.0-pro 相比基础档的优势恰好落在产品摄影需要的地方：主视觉图更干净的逼真细节，促销横幅可靠的文字渲染，而价格仍属适中的 $0.107/图。通过 /v1/tasks 并行提交主视觉图、横幅和变体网格请求，交付前校对任何带渲染文字的内容，当你是在迭代构图而非交付最终素材时，就改用基础档。qwen-image-2.0-pro 模型页面有实时定价和参数参考，可从这里继续。
