> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-custom-nodes-sdk-v2-frontend.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# RecraftV4TextToVectorNode - ComfyUI Built-in Node Documentation
> Recraft V4 Text to Vector 节点可根据文本描述，使用 Recraft V4 和 V4.1 模型生成可缩放矢量图形（SVG）插图。
Recraft V4 Text to Vector 节点可根据文本描述，使用 Recraft V4 和 V4.1 模型生成可缩放矢量图形（SVG）插图。它连接到 Recraft API，根据你的提示词生成一个或多个 SVG 文件，并可应用现有的矢量样式或根据参考图像创建新样式——使用参考图像时，创建的样式会以 `style_id` 形式返回，以便复用。
## 输入
### 通用输入
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| ------------------ | ------------------------------------------------------------------------------------------------------------ | -------------- | -- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `model` | 用于生成的模型。recraftv4\_styles 系列模型专为风格一致性生成而构建，始终需要 style\_id 或 style\_references。选择模型会改变可用的 `size` 选项。 | DYNAMIC\_COMBO | 是 | `"recraftv4_1_vector"`
`"recraftv4_1_utility_vector"`
`"recraftv4_1_pro_vector"`
`"recraftv4_1_utility_pro_vector"`
`"recraftv4"`
`"recraftv4_pro"`
`"recraftv4_styles_vector"`
`"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"`
`"flexible"` |
### recraftv4\_1\_vector、recraftv4\_1\_utility\_vector、recraftv4 和 recraftv4\_styles\_vector 输入
这些模型共享相同的 `size` 选项。
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| ------ | --------------------------- | ----- | -- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `size` | 生成图像的大小。默认值为 `"1024x1024"`。 | COMBO | 是 | `"1024x1024"`
`"1152x896"`
`"896x1152"`
`"1216x832"`
`"832x1216"`
`"1344x768"`
`"768x1344"`
`"1536x640"`
`"640x1536"` |
### recraftv4\_1\_pro\_vector、recraftv4\_1\_utility\_pro\_vector、recraftv4\_pro 和 recraftv4\_styles\_pro\_vector 输入
这些模型共享相同的 `size` 选项。
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| ------ | --------------------------- | ----- | -- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `size` | 生成图像的大小。默认值为 `"2048x2048"`。 | COMBO | 是 | `"2048x2048"`
`"2304x1792"`
`"1792x2304"`
`"2432x1664"`
`"1664x2432"`
`"2688x1536"`
`"1536x2688"`
`"3072x1280"`
`"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`