助手
扣子 AI 帮助与支持
你好,我是 扣子 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
扣子 3.0 都有什么新特性?
扣子和扣子编程有什么区别?
扣子如何收费?
文档反馈

ByteArtist 插件

ByteArtist 插件用于根据文本描述生成图像,支持指定图像数量和大小。
ByteArtist 插件包含 text2image 工具、image2image 工具、ImageToolPro 工具。不同工具的配置项不同,生成结果也不同。

使用限制

扣子主账号内所有子账号共享 ByteArtist 插件的并发限制 ,其值为 4。

计费说明

ByteArtist 插件根据插件调用次数计费,对应的计费项及单价请参考插件费用

说明

ByteArtist 插件内包含多个工具,调用这些工具的次数将共同计入该插件的免费额度。

text2image 工具

text2image 工具支持通过提示词生成图片,一次只能生成一张图片。

配置说明

使用 text2image 工具时,你需要输入提示词。同时,你也可以根据业务需求,指定图片风格、尺寸、宽高比例等参数,以满足个性化的图像生成需求。

输入参数

输入参数说明如下表所示:

参数

说明

prompt

设置用于生成图片的提示词,必填参数。

ddm_steps

设置用于生成图像的步数。值越大,生成的图片越精细,但花费时间也越长。

  • 取值范围:[1-50]。
  • 默认值:20。

height

设置待生成图片的高度。

  • 卡通风格
    • 取值范围:[128,768]。
    • 默认值:512。
  • 动漫风格
    • 取值范围:[576,1728]。
    • 默认值:1088。

    说明

    动漫风格的宽*高不可以超过 1088*1088 个像素点。

model_type

设置待生成图片的风格。

  • 0(默认值):通用风格。
  • 1:动漫风格。

negative_prompt

设置负面提示词,用于排除不希望生成的图像效果或元素。默认为 worst quality, low quality, normal quality, nsfw, glitch, deformed, mutated, disfigured, bad hands, signature, watermark, text, error, jpeg artifacts, blurry, overexposed, high-contrast, bad-contrast, pattern, duplicate, bad hand, missing fingers

ratio

设置待生成图像的宽高比例。

  • 1(默认值):1:1
  • 2:4:3
  • 3:16:9
  • 4:3:4
  • 5:9:16

scale

设置文本描述对生成图像的影响程度。

  • 取值范围:[1, 30]。
  • 默认值:7。

seed

设置随机种子,输入 -1 或正整数。

  • -1(默认值):系统将随机生成图片,每次生成结果不同。
  • 任意正整数:系统将基于该种子值生成相似的图片,确保结果可复现。

width

设置待生成图片的宽度。

  • 卡通风格
    • 取值范围:[128,768]。
    • 默认值:512。
  • 动漫风格
    • 取值范围:[576,1728]。
    • 默认值:1088。

    说明

    动漫风格的宽*高不可以超过 1088*1088 个像素点。

输出参数

参数

说明

log_id

日志 ID。

msg

执行插件时的状态描述或错误提示信息。

code

错误码。

data.images.image_url

图片生成后的图片 URL。URL 有效期为 30 天,请及时转存。

示例

调用 text2image 工具生成一张女孩图片。其中,设置提示词为一个中国年轻女孩,白色背景,黑色头发,长波
波头,正面脸,特写,工作室灯光,工作室,侧光,化妆肖像,穿白色衣服。图片生成后,你可以通过输出结果中的图片链接查看图片。
Image
效果图如下:
Image

image2image 工具

image2image 工具支持根据你所提供的原始图片和提示词生成新的图片,一次只能生成一张图片。

配置说明

在使用 image2image 工具时,你需要上传原始图片及输入提示词。同时,你也可以根据业务需求,指定原图的修改强度、负面提示词等参数,以满足个性化的图像生成需求。

输入参数

输入参数说明如下表所示:

参数

说明

prompt

设置用于生成图像的提示词,必填参数。

url

设置原始图片来源,必填参数。
支持输入图片链接或引用上游节点的输出参数。

说明

在调试节点效果时,建议输入一个图片链接,用于调整参数配置,并仅测试该节点,快速查看效果。

ddm_steps

设置用于生成图像的步数。值越大,生成的图片越精细,但花费时间也越长。

  • 取值范围:[1-50]。
  • 默认值:20。

model_type

设置模型版本名称。目前仅支持设置为 1,表示使用 anime_v1.3 模型。

negative_prompt

设置负面提示词,用于排除不希望生成的图像效果或元素。默认为"worst quality, low quality, normal quality, nsfw, glitch, deformed, mutated, disfigured, bad hands, signature, watermark, text, error, jpeg artifacts, blurry, overexposed, high-contrast, bad-contrast, pattern, duplicate, bad hand, missing fingers"。

scale

设置文本描述对生成图像的影响程度。值越大,影响程度越大。

  • 取值范围:[1, 30]。
  • 默认值:7。

seed

设置随机种子,输入 -1 或正整数。

  • -1(默认值):系统将随机生成图片,每次生成结果不同。
  • 任意正整数:系统将基于该种子值生成相似的图片,确保结果可复现。

strength

设置对原图的修改强度。值越大,生成的图片与原图差别越大。

  • 取值范围:[0.0, 1.0]。
  • 默认值:0.7。

输出参数

参数

说明

log_id

日志 ID。

msg

执行插件时的状态描述或错误提示信息。

code

错误码。

data.images.image_url

图片生成后的图片 URL。URL 有效期为 30 天,请及时转存。

ImageToolPro 工具

text2image 工具支持通过提示词生成多种风格的图片。

配置说明

在使用 image2image 工具时,你需要输入提示词和图片风格。

输入参数

输入参数说明如下表所示:

参数

说明

prompt

设置用于生成图片的提示词。必填参数。

model_type

设置待生成图片的风格。必填参数。

  • 0:通用风格。
  • 1:卡通风格。
  • 2:根据用户输入的图片生成。
  • 3:像素贴纸风格。

image_url

设置原始图片来源。支持输入图片链接或引用上游节点的输出参数。

说明

  • 设置 model_type2 时,必须设置图片链接。
  • 在调试节点效果时,建议输入一个图片链接,用于调整参数配置,并仅测试该节点,快速查看效果。

输出参数

参数

说明

log_id

日志 ID。

msg

执行插件时的状态描述或错误提示信息。

code

错误码。

data.prompt

生成图片的提示词。

data.image_url

图片生成后的图片 URL。URL 有效期为 30 天,请及时转存。

示例

调用 ImageToolPro 工具生成一张小狗图片。其中,设置 prompt两只黄色的小狗,设置 model_type1,即卡通风格。图片生成后,你可以通过输出结果中的图片链接查看图片。
Image
效果图如下:
Image

  • ByteArtist插件 ID:7348853341922983946