Ideogram Vector 1.0 Text to Vector API

ideogram/vector-1.0/text-to-vector
SVG · low · medium · high

Ideogram Vector 1.0 Text to Vector 将提示词转化为 Logo、图标与插画的 SVG 作品,支持最多 5 张参考图与 17 种比例。真正的矢量文件可从图标到大幅面清晰缩放。

获取 API Key
Input
必填324/9500
可选
Image Urls

拖拽文件、粘贴剪贴板素材,或输入 URL。 可选:1–5 张参考图,第一张为主参考图。

可选
可选
可选
Output已就绪

预计费用: 32 credits · $0.1600

提交任务时预扣积分,任务失败将全额退还。

继续使用

示例

output-01.svg

A set of four matching line-style weather icons in a row: sun, cloud, rain cloud, snowflake. Uniform stroke width, rounded caps, single navy colour with a cyan accent, transparent-feeling white background. No brand names, logos, watermark, split screen or comparison panels.

Ideogram Vector 1.0 Text to Vector

Ideogram Vector 1.0 是 Ideogram 首个直接绘制矢量而非像素的模型。Text to Vector 端点接收最长 9,500 字符的提示词与可选参考图,单次返回 1–8 个 SVG 文件。Ideogram 介绍其输出为干净、可编辑的 SVG,带有平滑渐变,文字以矢量形状绘制,可直接用于设计软件、印刷与网页。

为什么选择 Ideogram Vector 1.0 Text to Vector?

  • 原生 SVG 输出每个结果都是以矢量形状生成的 .svg 文件,而不是位图描摹,任意尺寸下都保持清晰。

  • 参考图引导风格添加 1–5 张 image_urls 引导配色、线条粗细或主体;第一张作为主参考图。

  • 从 4:1 横幅到 1:4 长条可选 auto 或 17 种比例,包括 16:10、10:16、3:1、4:1,适合徽章、页眉、标识与竖幅。

  • 三档画质low、medium、high 每个 SVG 分别为 26、32、40 积分;high 搭配参考图为 64 积分。

  • 单次多个方案n 可设为 1–8,在一个任务中比较多个 Logo 或图标方向。

参数

参数要求说明
prompt必填

非空文本,最多 9,500 个字符。

image_urls可选

可选参考图:1–5 个公开 HTTP(S) URL 或图片 data URI。没有参考图时不要传该字段。

quality可选

low、medium 或 high,决定每个 SVG 的价格。

默认值mediumlowhigh
n可选

SVG 文件数量,整数 1–8。

默认值1
size可选

画幅比例:auto, 1:1, 1:4, 1:3, 1:2, 9:16, 10:16, 2:3, 3:4, 4:5, 5:4, 4:3, 3:2, 16:10, 16:9, 2:1, 3:1, 4:1。

默认值auto

使用方法

  1. 描述作品写明主体、风格(扁平、线条、徽章)与颜色数量,并用引号标出需要出现的短文字。

  2. 按需添加参考图附上最多 5 张图片,让 SVG 沿用其配色或线条风格。

  3. 选择画质、比例与数量选择画质档位、匹配目标版位的比例,以及需要比较的方案数量。

  4. 下载 SVG提交 model 为 ideogram/vector-1.0/text-to-vector 的请求,用 task_id 轮询,并从 files 下载每个 .svg 地址。

用量与计费

按输出 SVG 数量计费,总积分 = 单价 × n。1 积分 = $0.005。

使用 image_urls 时,low 与 medium 保持原价,只有 high 变为 64 积分。提交时预扣积分,任务失败全额退还。

用量与计费
选项积分 / SVG美元 / SVG
low26$0.13
medium32$0.16
high(仅提示词)40$0.20
high + image_urls64$0.32

最佳使用场景

  • 应用内 SVG 导出功能让用户输入描述即可获得 SVG,在你的产品中放置、改色或导出。

  • 按需印刷与周边为 T 恤、贴纸和马克杯制作可缩放图稿,无需放大导致失真。

  • 图标集与插图为应用、文档与演示文稿生成风格统一的线性或扁平图标。

  • Logo 与徽章探索先比较多个矢量方向,再在矢量编辑器中深化其中一个。

使用技巧

  • 在提示词中限制配色(例如三种颜色),形状更干净,也更便于后期编辑。
  • 把主要风格参考图放在 image_urls 第一位,其余图片作为次要参考。
  • 先用 low 画质、n 设为 4 探索,再用 medium 或 high 重跑选中的提示词。
  • 页眉和横幅直接选择 3:1 或 4:1 等宽比例,而不是裁剪方图。

注意事项

  • 结果为 SVG 文件 URL,可在矢量编辑器中打开,或直接嵌入网页。
  • 传入 image_urls 时必须包含 1–5 张;纯提示词请求请不要传 image_urls 字段。
  • 没有 SVG 编辑端点。需要修改时,请调整提示词重新生成,或用 Image to Vector 矢量化修改后的位图。

相关模型

Ideogram Vector 1.0 Text to Vector API 常见问题

Ideogram Vector 1.0 Text to Vector API 是什么?

Ideogram Vector 1.0 Text to Vector 是 Ideogram 用于根据文字提示词创建 SVG 矢量图形的模型。它可生成 Logo、图标与插画,单次输出 1–8 个 SVG 文件,并可通过最多 5 张参考图和 auto 加 17 种比例进行引导。由于形状直接以矢量生成而非从像素描摹,文件可清晰缩放,并能在任意矢量编辑器中打开。你可以通过 API 进行程序化调用,也可以在上方体验区直接在线试用。

Ideogram Vector 1.0 Text to Vector 返回什么文件格式?

每个输出都是 SVG 文件(image/svg+xml),以 URL 形式出现在 files 中,可嵌入网页或在矢量设计工具中打开。

Ideogram Vector 1.0 Text to Vector 怎么收费?

每个 SVG:low 26 积分($0.13),medium 32 积分($0.16),high 40 积分($0.20),high 搭配参考图 64 积分($0.32)。总价为单价乘以 n。

Ideogram Vector 1.0 Text to Vector 能用几张参考图?

image_urls 支持 1–5 张。第一张为主参考图,其余为补充参考。

Ideogram Vector 1.0 Text to Vector 支持哪些比例?

auto, 1:1, 1:4, 1:3, 1:2, 9:16, 10:16, 2:3, 3:4, 4:5, 5:4, 4:3, 3:2, 16:10, 16:9, 2:1, 3:1, 4:1。默认 auto。

Ideogram Vector 1.0 Text to Vector 输出的文字可以编辑吗?

文字以矢量形状绘制,可在矢量编辑器中改色、移动和缩放。如果需要修改具体字符,建议重新输入文字。

如何修改 Ideogram Vector 1.0 Text to Vector 的结果?

可在矢量编辑器中直接编辑 SVG,或修改提示词重新生成。需要矢量化修改后的位图草稿时,请使用 Ideogram Vector 1.0 Image to Vector。

什么时候用 Ideogram Vector 1.0 Text to Vector 而不是 Ideogram 4.5?

当交付物需要无损缩放或按形状编辑时,例如 Logo、图标、标识与周边,选择 Text to Vector;需要摄影感或绘画感的位图时,选择 Ideogram 4.5。