RecraftV4TextToImageNode - ComfyUI Built-in Node Documentation

Recraft V4 文本到图像此节点使用 Recraft V4 和 V4.1 AI 模型，根据文本描述生成图像。它将您的提示词发送到外部 API，并返回生成的图像。您可以通过指定模型、图像尺寸、图像数量以及可选样式（以已保存的样式 ID 或参考图像的形式）来控制输出。

输入

通用输入

参数	描述	数据类型	必填	范围
`model`	用于生成的模型。recraftv4_styles 模型专为风格一致性生成而构建，始终需要 style_id 或 style_references。	DYNAMIC_COMBO	是	”recraftv4_1" "recraftv4_1_utility" "recraftv4_1_pro" "recraftv4_1_utility_pro" "recraftv4" "recraftv4_pro" "recraftv4_styles" "recraftv4_styles_pro”
`prompt`	图像生成的提示词。最多 10,000 个字符。	STRING	是	1 到 10000 characters
`negative_prompt`	此输入会被忽略：Recraft V4 和 V4.1 模型不支持负向提示词。	STRING	是	N/A
`n`	要生成的图像数量（默认值：1）。	INT	是	1 到 6
`seed`	用于确定节点是否应重新运行的种子；无论种子如何，实际结果都是不确定的（默认值：0）。	INT	是	0 到 18446744073709551615
`recraft_controls`	通过 Recraft Controls 节点对生成过程的可选附加控制。	CUSTOM	否	N/A
`style_id`	要应用的 Recraft V4 样式的 UUID，例如来自 Recraft V4 Create Style 节点或先前运行的 style_id 输出。不能与 style_references 组合使用（默认值：空）。	STRING	否	Valid UUID string
`style_match`	对样式的遵循程度：precise 会精细复现样式，flexible 会匹配大致外观。仅在提供样式时使用（默认值：“precise”）。	COMBO	否	”precise" "flexible”

recraftv4_1、recraftv4_1_utility、recraftv4 和 recraftv4_styles 输入

这些模型共享相同的 size 参数。

参数	描述	数据类型	必填	范围
`size`	生成图像的尺寸（默认值：“1024x1024”）。	COMBO	是	Multiple options available (standard Recraft V4 sizes, includes “1024x1024”)

recraftv4_1_pro、recraftv4_1_utility_pro、recraftv4_pro 和 recraftv4_styles_pro 输入

这些模型共享相同的 size 参数。

参数	描述	数据类型	必填	范围
`size`	生成图像的尺寸（默认值：“2048x2048”）。	COMBO	是	Multiple options available (pro Recraft V4 sizes, includes “2048x2048”)

参考输入

参数	描述	数据类型	必填	范围
`style_references`	用于即时创建样式的参考图像，计费在生成费用之上。创建的样式会作为 style_id 返回以供复用。不能与 style_id 组合使用。可增长插槽：连接 1..N 张图像（style_reference_1、style_reference_2、…）。	IMAGE	否	0 to the maximum number of reference images allowed by the Recraft API; total encoded size must not exceed 10 MB

注意： size 参数是一个动态输入，其可用选项会根据所选 model 而变化。recraftv4_styles 和 recraftv4_styles_pro 模型始终需要样式：连接参考样式图像或提供 style_id。style_id 和 style_references 输入互斥——只能提供其中一个。style_id 必须是有效的 UUID。style_match 输入仅在提供样式时使用。参考样式图像的计费在生成费用之上，且其总编码大小不得超过 10 MB。seed 值不能保证图像输出的可复现性。如果您使用来自 Infinite Style Library 的样式 ID，请确保它不是 Vector art 样式，因为这可能会返回 SVG 数据而不是图像。

输出

输出名称	描述	数据类型
`output`	生成的图像或图像批次。	IMAGE
`style_id`	本次生成使用或创建的样式 ID。当提供参考样式图像时，这里会返回创建的样式以供复用；未使用样式时返回空字符串。	STRING

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！在 GitHub 上编辑

Source fingerprint (SHA-256): af5c1f68e59ca282cdca7c32cd50f0438b743fdda27d9d22e59b2d1343f45e26

​输入

​通用输入

​recraftv4_1、recraftv4_1_utility、recraftv4 和 recraftv4_styles 输入

​recraftv4_1_pro、recraftv4_1_utility_pro、recraftv4_pro 和 recraftv4_styles_pro 输入

​参考输入

​输出

输入

通用输入

recraftv4_1、recraftv4_1_utility、recraftv4 和 recraftv4_styles 输入

recraftv4_1_pro、recraftv4_1_utility_pro、recraftv4_pro 和 recraftv4_styles_pro 输入

参考输入

输出