# Recraft V4 文本转矢量

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`
