image · 2026-10-05
生图 / 改图
三入口同一套生图字段：https://ttkk.inping.com/v1、https://ttqq.inping.com/v1、https://api.clavue.com/v1。公网 hop 对 clavue-img / 引擎名会强制 response_format=b64_json（避免 ClusterIP 坏链）。尺寸白名单：1024×1024 / 768×1344 / 1344×768（写 512 会被升到 1024）。写图 prompt 的 chat 打裸 27b/35b（零注入）；不要用 clavue-3-chat 生成视觉简报。
2026-09-21 改图换代：改图已从 Qwen-Image-Edit-2509 全面换成 Qwen-Image-2.1（7B 统一生图/改图）。
新架构不兼容旧的证件照 / 写真 LoRA，两个 LoRA 已不存在。评测结论：光杆 2.1 的身份保持
优于当初训练这两个 LoRA 的教师金标，不需要重训。
调用方可通过响应里的 adapter 字段检测（现恒为 ""）。
| model | 端点 | 做什么 |
|---|---|---|
clavue-img | POST /v1/images/generations | 产品文生图（hop 改写成 z-image-turbo，steps=9） |
z-image-turbo | 同上 | 引擎直打。集群 6 路，权重 ALB4（MH8+写真）。不带 response_format 时 hop 也会注入 b64 |
qwen-image-edit | POST /v1/images/edits | Qwen-Image-2.1 指令改图，保身份。单图 ~75s（40 步） |
clavue-id / qwen-image-edit-id | /v1/images/edits | 证件照用途。走同一个 2.1 后端，无 LoRA（adapter=""） |
clavue-album / qwen-image-edit-album | POST /v1/images/edits | 写真用途。ttkk / ttqq / api.clavue.com 都用这个端点。无 LoRA。打 /v1/images/generations 会 404，这是端点不对，不是集群故障 |
clavue-seg-v1 | POST /v1/images/segments | GroundingDino+SAM2 分段 |
clavue-inpaint-v1 | /v1/images/edits | SDXL 区域编辑 |
clavue-tryon-v1 | POST /v1/images/try-on | 虚拟换衣，mask 外部提供 |
旧 id z-image-album / z-image-manhua：对应 Deployment 已于 2026-09-21 删除，但这两个 id 仍由 z-image-turbo 自报、仍可出图（等同 turbo 别名）。新代码请直接用 z-image-turbo。
文生图
curl -sS https://ttkk.inping.com/v1/images/generations \
-H "Authorization: Bearer $CLAVUE_KEY" -H 'Content-Type: application/json' \
-d '{"model":"clavue-img","prompt":"清晨窗边，暖光，胶片感","size":"1024x1024","output_format":"webp"}'
不传 output_format 时默认 WebP（quality 80）。b64_json 是这种编码的字节，文件头是 RIFF…WEBP。响应里的 output_format 会回显实际编码。
| output_format | 何时用 | 字节 |
|---|---|---|
webp（默认） | 普通展示、要更快的下载 | WebP quality 80。文件头 RIFF…WEBP |
jpeg 或 jpg | 只要 JPEG 的客户端 | JPEG quality 85。文件头 FF D8 |
png | 素材图，要无损 | PNG。文件头 89 50 4E 47 |
同一张图，WebP 远小于 PNG。512 边长上测过大约 33KB / 56KB / 392KB；公网白名单会把 512 升到 1024，文件更大，比例仍是 WebP 最小、PNG 最大。换格式不改变生成时间。客户端超时仍 ≥ 120 s。别把默认的 b64_json 按 PNG 解码；要 PNG 就传 "output_format":"png"。其它取值，api.clavue.com 和 z-image 引擎都返回 400。
ttqq 把主机名换成 https://ttqq.inping.com/v1，body 相同。api.clavue.com 用 model=clavue-img，画幅用 aspect_ratio（1:1 / 9:16 / 16:9），同样可带 output_format。主引擎失败切到备用通道时，响应里的 output_format 以实际字节为准。
改图
curl -sS https://ttkk.inping.com/v1/images/edits \ -H "Authorization: Bearer $CLAVUE_KEY" \ -F model=clavue-album -F prompt="换成冬装，保留脸" -F image=@in.png
普通改图把 model 换成 qwen-image-edit，证件照用 clavue-id。api.clavue.com 同一路径。请传正常尺寸原图；1×1 占位图会在 GPU 上失败，那不是 404。
2.1 已改为 40 步，单图约 75 s（fp16 的 2080Ti 约 91 s）。客户端超时请设 ≥ 300 s。
显式要 response_format=url 时后端仍可能给 ClusterIP，公网打不开。产品路径用默认 b64。