GPU API工具箱 API 文档Proxy Base URL（画布内部）图片类
Krea2 文生图
无参考图的 Krea2 GPU 生图，通过 Proxy 提交、查询和下载
Krea2 文生图
model=krea2 是零参考图的文生图模型，和 krea2-edit、krea2-turbo-v25-edit 等图片编辑模型是不同入口。
画布、生图工作台和 API 共用 Proxy，不需要另建工作流或直连 GPU。
| 项目 | 契约 |
|---|---|
| 模型发现 | GET /api/proxy/v1/models，查找 id=krea2 |
| 异步提交（推荐） | POST /api/proxy/v1/images/generations/tasks，JSON |
| 同步提交 | POST /api/proxy/v1/images/generations，相同 JSON |
| 必填 | model、prompt |
| 可选 | size，默认 1024x1536；n，默认 1，建议每任务 1 张 |
| 尺寸 | WIDTHxHEIGHT；Proxy 将长边等比限制到 1536，并把每边限制在 256–1536 |
| 输出数量 | 1–4 张；工作台的更多张数由客户端拆成独立任务 |
| 参考图 | 无；有参考图时选择对应编辑模型 |
生产主站为 https://ic.xshow.live，开发站为 https://dev.ic.xshow.live。以下示例使用当前环境的登录会话 IC_SESSION；同源 BFF 负责鉴权、计费和任务归属，不是匿名 API，也不接受把 Scheduler Key 当作用户登录凭证。服务内 Proxy 路径去掉 /api/proxy，但只供既有内部调用方使用，不直接公开服务端端口。
提交
BASE_URL=https://ic.xshow.live
OPERATION_ID=$(uuidgen)
curl --fail-with-body -X POST "$BASE_URL/api/proxy/v1/images/generations/tasks" \
-H "Cookie: ic_session=$IC_SESSION" \
-H "X-IC-Operation-ID: $OPERATION_ID" \
-H 'Content-Type: application/json' \
-d '{"model":"krea2","prompt":"蓝色陶瓷花瓶放在木桌上，柔和自然光，静物摄影","size":"1024x1536","n":1}'保存返回的 id 作为 TASK_ID。GPU 排队较长时不要重复创建任务。操作 ID 必须按一次逻辑生成保存，断线后先恢复原操作状态；不要用新 ID 盲目重试。
查询、下载与取消
curl --fail-with-body -X POST "$BASE_URL/api/proxy/v1/images/tasks/$TASK_ID" \
-H "Cookie: ic_session=$IC_SESSION"
# 仅在 status=completed 后下载；多张结果按 index=0..n-1 分别读取。
curl --fail-with-body "$BASE_URL/api/proxy/v1/images/tasks/$TASK_ID/content?index=0" \
-H "Cookie: ic_session=$IC_SESSION" -o krea2-result.png
# 用户明确取消时调用，不作为正常完成后的步骤。
curl --fail-with-body -X POST "$BASE_URL/api/proxy/v1/images/tasks/$TASK_ID/cancel" \
-H "Cookie: ic_session=$IC_SESSION"pending / running 继续轮询；failed / cancelled 停止并保留错误信息。
同步接口返回 {created,data:[{b64_json}]}，不是下载 URL；异步接口返回任务 ID，结果需从上述归属校验接口读取。
可用性与边界
- 先读取
/api/proxy/v1/models?refresh=true：ready=false仍保留模型和missing原因；出现目录不等于推理效果已验收。 - 当前 Proxy 的 Krea2 文生图分支没有透传调用方
seed，不要用它承诺可重复生成。编辑模型的seed是另外的契约。 - 单独指定明星身份时使用 明星 Krea2 模型，不是向
krea2随意传入 LoRA 路径。 - 完整 GPU 图片模型和参考图约束见 GPU API 技术参考 的中央 GPU 图片矩阵。