> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# RecraftV4TextToVectorNode - ComfyUI Built-in Node Documentation

> Recraft V4 文本转矢量节点使用 Recraft V4 和 V4.1 模型，根据文本描述生成可缩放矢量图形（SVG）插图。

Recraft V4 文本转矢量节点使用 Recraft V4 和 V4.1 模型，根据文本描述生成可缩放矢量图形（SVG）插图。它连接到 Recraft API，根据你的提示词生成一个或多个 SVG 文件，并且可以应用现有的矢量样式，或从参考图像创建新样式——使用参考图像时，创建的样式会作为 `style_id` 返回以供复用。

## 输入

### 通用输入

| 参数                 | 描述                                                                                                           | 数据类型           | 必填 | 范围                                                                                                                                                                                                                                                 |
| ------------------ | ------------------------------------------------------------------------------------------------------------ | -------------- | -- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `model`            | 用于生成的模型。recraftv4\_styles 模型专为风格一致的生成而构建，并且始终需要 `style_id` 或 `style_references`。选择模型会改变可用的 `size` 选项。        | DYNAMIC\_COMBO | 是  | `"recraftv4_1_vector"`<br />`"recraftv4_1_utility_vector"`<br />`"recraftv4_1_pro_vector"`<br />`"recraftv4_1_utility_pro_vector"`<br />`"recraftv4"`<br />`"recraftv4_pro"`<br />`"recraftv4_styles_vector"`<br />`"recraftv4_styles_pro_vector"` |
| `prompt`           | 用于图像生成的提示词。最多 10,000 个字符。                                                                                    | STRING         | 是  | N/A                                                                                                                                                                                                                                                |
| `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         | 否  | N/A                                                                                                                                                                                                                                                |
| `style_match`      | 遵循样式的紧密程度：precise 会详细复现它，flexible 匹配整体外观。仅在提供样式时使用（默认："precise"）。                                            | COMBO          | 否  | `"precise"`<br />`"flexible"`                                                                                                                                                                                                                      |

### recraftv4\_1\_vector、recraftv4\_1\_utility\_vector、recraftv4 和 recraftv4\_styles\_vector 输入

这些模型共享相同的 `size` 选项。

| 参数     | 描述                         | 数据类型  | 必填 | 范围                                                                                                                                                            |
| ------ | -------------------------- | ----- | -- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `size` | 生成图像的尺寸。默认为 `"1024x1024"`。 | COMBO | 是  | `"1024x1024"`<br />`"1152x896"`<br />`"896x1152"`<br />`"1216x832"`<br />`"832x1216"`<br />`"1344x768"`<br />`"768x1344"`<br />`"1536x640"`<br />`"640x1536"` |

### recraftv4\_1\_pro\_vector、recraftv4\_1\_utility\_pro\_vector、recraftv4\_pro 和 recraftv4\_styles\_pro\_vector 输入

这些模型共享相同的 `size` 选项。

| 参数     | 描述                         | 数据类型  | 必填 | 范围                                                                                                                                                                    |
| ------ | -------------------------- | ----- | -- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `size` | 生成图像的尺寸。默认为 `"2048x2048"`。 | COMBO | 是  | `"2048x2048"`<br />`"2304x1792"`<br />`"1792x2304"`<br />`"2432x1664"`<br />`"1664x2432"`<br />`"2688x1536"`<br />`"1536x2688"`<br />`"3072x1280"`<br />`"1280x3072"` |

### 参考输入

| 参数                 | 描述                                                                           | 数据类型  | 必填 | 范围                            |
| ------------------ | ---------------------------------------------------------------------------- | ----- | -- | ----------------------------- |
| `style_references` | 用于即时创建矢量样式的参考图像，会在生成费用之外额外计费。创建的样式会作为 `style_id` 返回以供复用。不能与 `style_id` 组合使用。 | IMAGE | 否  | 可增长槽：连接 1..N 张参考图像（最多到节点的最大值） |

**注意：** `size` 参数是一个动态输入，其可用选项会根据所选的 `model` 变化。`seed` 值不保证外部 API 产生可复现的结果。`recraftv4_styles_vector` 和 `recraftv4_styles_pro_vector` 模型始终需要样式：提供 `style_id` 或连接至少一张 `style_references` 图像。`style_id` 和 `style_references` 不能同时使用——同时提供会引发错误，且 `style_id` 必须是有效的 UUID。样式参考图像数量有限，其总编码大小不得超过 10 MB。

## 输出

| 输出名称       | 描述                                                      | 数据类型   |
| ---------- | ------------------------------------------------------- | ------ |
| `output`   | 生成的可缩放矢量图形（SVG）图像。                                      | SVG    |
| `style_id` | Recraft API 返回的样式 UUID。当提供参考图像时，创建的样式会在此返回以供复用；否则为空字符串。 | STRING |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/RecraftV4TextToVectorNode/zh.md)

***

**Source fingerprint (SHA-256):** `182a40b206b164cf2e96c7344d23e4906b7d61b90e3000743a3fd31941e08539`
