Skip to content

文生图

下面的接口调用依赖于您已经安装了 文生图 应用,点击跳转安装

文生图的接口是兼容 OpenAI 的 API 格式。

  1. 获取模型接口(目前仅有一个默认模型 sd-cpp-local 对应 z-image-turbo)

curl https://imagen-ai.$微服名称.heiyu.space/v1/models

  1. 生成图片接口(https://platform.openai.com/docs/api-reference/images/create)
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 生成种子,默认值是随机值,可以手动指定同一个种子以得到稳定一致的结果,特殊需求下需要这个参数