GPU API工具箱 API 文档Proxy Base URL(画布内部)图片类
明星 Krea2 生图与编辑
发现全部明星模型 ID,并通过同一 Proxy 调用文生图或单图编辑
明星 Krea2 生图与编辑
明星系列是独立的公开模型 ID:krea2-girlslike-{alias}。每个 ID 固定一个身份,共用中央 GPU 工作流。
无参考图走文生图,有 1 张参考图走编辑,不需要先调用换脸接口。当前注册表包含 50 个 ID,调用方始终以运行环境的模型发现结果为准,不手写一份容易遗漏的名单。
发现全部明星模型
BASE_URL=https://ic.xshow.live
curl --fail-with-body "$BASE_URL/api/proxy/v1/models?refresh=true" \
-H "Cookie: ic_session=$IC_SESSION" |
jq '.data[] | select(.capability == "image" and (.id | startswith("krea2-girlslike-"))) | {id,name,alias,modes,ready,missing}'name 是显示名称,alias 是公开简称,modes 为 generation / edit。
ready=false 的模型仍在目录内,需显示 missing,不要自动切换成另一个明星或普通 Krea2。
例如 krea2-girlslike-lyf 对应刘亦菲、krea2-girlslike-ym 对应杨幂;请求使用模型 ID,不传中文名称作为 model。
文生图:不传图片
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: $(uuidgen)" \
-H 'Content-Type: application/json' \
-d '{"model":"krea2-girlslike-lyf","prompt":"穿白色衬衫的棚拍肖像,柔和自然光,简洁灰色背景","size":"1024x1536","n":1}'| 参数 | 文生图约束 |
|---|---|
model | 从上述发现接口选择一个完整明星 ID |
prompt | 场景、服装、光线等描述;身份标签由服务端补齐 |
size | 默认 1024x1536,宽高各 256–2048,均为 32 的倍数 |
n | 1–4,默认 1;建议每任务 1 张 |
编辑:恰好 1 张参考图
curl --fail-with-body -X POST "$BASE_URL/api/proxy/v1/images/edits/tasks" \
-H "Cookie: ic_session=$IC_SESSION" \
-H "X-IC-Operation-ID: $(uuidgen)" \
-F 'model=krea2-girlslike-lyf' \
-F 'prompt=保留构图与自然光,将背景改为浅蓝色摄影棚' \
-F 'image=@reference.png;type=image/png' \
-F 'output_sizing=source_ratio' \
-F 'seed=12345'编辑每任务输出 1 张;output_sizing 为 source_ratio 或 source_exact,seed 取 0 到 2^63−1。
图片 part 必须使用真实 image/* MIME,图片顺序及数量不通过普通 JSON 代替。
公共生命周期与限制
- 两种模式均保存返回的
id,使用POST /api/proxy/v1/images/tasks/{id}查询;完成后从GET /api/proxy/v1/images/tasks/{id}/content?index=0下载。完整轮询、取消和会话说明见 Krea2 文生图。 - 同步入口分别为
/api/proxy/v1/images/generations、/api/proxy/v1/images/edits,返回b64_json;排队场景优先用异步入口。 - 身份和 trigger 由服务端注册表固定;不要传
celebrity、LoRA 路径、权重、trigger 覆盖或普通 Krea2 的姿势参数。 - 文生图不支持
quality、mask、output_sizing;编辑不支持quality、mask、size、width、height。文生图当前没有透传seed,不要据此承诺可复现。 IC_SESSION只代表用户会话,不向客户端暴露 GPU 地址、内部鉴权或模型资产路径。目录可用性不替代实际图像与身份效果验收。