文生图
下面的接口调用依赖于您已经安装了 文生图 应用,点击跳转安装
文生图的接口是兼容 OpenAI 的 API 格式。
- 获取模型接口(目前仅有一个默认模型 sd-cpp-local 对应 z-image-turbo)
curl https://imagen-ai.$微服名称.heiyu.space/v1/models
curl https://imagen-ai.微服.heiyu.space/v1/images/generations \
-H "Content-Type: application/json" \
-d '{
"model": "sd-cpp-local",
"prompt": "A lovely cat",
"n": 1,
"size": "512x512",
"response_format": "b64_json"
}' \
-o >(jq -r '.data[0].b64_json' | base64 --decode > output.png)参数用法同 OpenAI:
- prompt 提示词
- n 生成图片数量
- size 图片尺寸,长和宽都必须是 16 的整数倍否则不合法
- response_format 目前仅支持这个固定格式
模型特定参数:因为 OpenAI 格式未预留额外参数接口,因此当前版本可以将 Z-Image-Turbo 的一些高级参数放到提示词里
"prompt": "A lovely cat<sd_cpp_extra_args>{\"seed\": 357925}</sd_cpp_extra_args>",当前主要有:
- steps 迭代步数,当前版本后端设置的默认值是 7, 模型推荐值是 9,取值范围 0-9,步数越少生成越快,比如演示测试时可以指定为 4 步来快速生成,不用等太久。另外这个 turbo 是蒸馏过的模型,步数不能超过 20,否则会过渲染图像无法使用
- seed 生成种子,默认值是随机值,可以手动指定同一个种子以得到稳定一致的结果,特殊需求下需要这个参数