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 API
ideogram/vector-1.0/text-to-vectorIdeogram Vector 1.0 Text to Vector 将提示词转化为 Logo、图标与插画的 SVG 作品,支持最多 5 张参考图与 17 种比例。真正的矢量文件可从图标到大幅面清晰缩放。
获取 API Key拖拽文件、粘贴剪贴板素材,或输入 URL。 可选:1–5 张参考图,第一张为主参考图。
预计费用: 32 credits · $0.1600
提交任务时预扣积分,任务失败将全额退还。
示例
REST API
快速开始
以下流程提交一个合法的 Ideogram Vector 1.0 Text to Vector 请求,取得 task_id,并在异步任务结束后读取结果文件 URL。
连接 Vidgo API
创建 API Key,仅保存在服务端,并通过 Authorization: Bearer VIDGO_API_KEY 发送。
- 端点
- POST
https://api.vidgo.ai/api/generate/submit - 认证
- Authorization: Bearer VIDGO_API_KEY
提交一个任务
向统一提交端点发送当前模型 ID 与 input 对象。input 只能包含本端点参数表列出的字段,其他字段会返回 400。
curl --request POST \
--url "https://api.vidgo.ai/api/generate/submit" \
--header "Authorization: Bearer $VIDGO_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "ideogram/vector-1.0/text-to-vector",
"input": {
"prompt": "A flat vector badge of a friendly fox head inside a circle, bold clean outlines, three-colour palette of orange, cream and deep teal, smooth gradient on the background disc. Text along the bottom arc reads exactly \"TRAIL CLUB\". Centered, generous padding. No brand names, logos, watermark, split screen or comparison panels.",
"quality": "medium",
"size": "1:1",
"n": 1
}
}'等待结果
读取 data.task_id,仅在 not_started 或 running 时继续轮询;finished 与 failed 都必须停止。
查询状态
GET https://api.vidgo.ai/api/generate/status/{task_id}建议每 2–5 秒查询一次,并对 429/5xx 退避。也可在顶层提供 callback_url,在任务进入终态时接收回调。
not_startedrunningfinishedfailed{
"code": 200,
"data": {
"task_id": "task-example",
"status": "not_started",
"created_time": "2026-11-03T08:00:00"
}
}{
"code": 200,
"data": {
"task_id": "task-example",
"status": "finished",
"created_time": "2026-11-03T08:00:00",
"progress": 100,
"files": [
{
"file_url": "https://example.com/result.svg",
"file_type": "image"
}
]
}
}完整可运行轮询示例
展开后可查看同一 payload 的端到端脚本,包含业务 code、缺失 task_id、失败状态、异常状态和网络错误处理。
set -euo pipefail
: "${VIDGO_API_KEY:?Set VIDGO_API_KEY in your environment}"
REQUEST_BODY=$(cat <<'JSON'
{
"model": "ideogram/vector-1.0/text-to-vector",
"input": {
"prompt": "A flat vector badge of a friendly fox head inside a circle, bold clean outlines, three-colour palette of orange, cream and deep teal, smooth gradient on the background disc. Text along the bottom arc reads exactly \"TRAIL CLUB\". Centered, generous padding. No brand names, logos, watermark, split screen or comparison panels.",
"quality": "medium",
"size": "1:1",
"n": 1
}
}
JSON
)
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
--request POST \
--url "https://api.vidgo.ai/api/generate/submit" \
--header "Authorization: Bearer $VIDGO_API_KEY" \
--header "Content-Type: application/json" \
--data "$REQUEST_BODY")
TASK_ID=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.data.task_id // .task_id // empty')
if [ -z "$TASK_ID" ]; then
printf 'Submit response did not include task_id:
%s
' "$SUBMIT_RESPONSE" >&2
exit 1
fi
while true; do
STATUS_RESPONSE=$(curl --silent --show-error --fail-with-body \
--url "https://api.vidgo.ai/api/generate/status/$TASK_ID" \
--header "Authorization: Bearer $VIDGO_API_KEY")
STATUS=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.data.status // .status // empty')
case "$STATUS" in
finished)
printf '%s' "$STATUS_RESPONSE" | jq -r '(.data.files // .files // [])[]?.file_url'
break
;;
failed)
printf '%s' "$STATUS_RESPONSE" | jq -r '.data.error_message // .error_message // "Generation failed"' >&2
exit 1
;;
not_started|running)
sleep 2
;;
*)
printf 'Unexpected task status: %s
' "$STATUS" >&2
exit 1
;;
esac
done请求参数
下表仅列出 input 对象内的公开字段。顶层 model 与可选 callback_url 请参考快速开始示例。
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| input.prompt | string | 是 | – | 非空文本,最多 9,500 个字符。 |
| input.image_urls | string[] | 否 | – | 可选参考图:1–5 个公开 HTTP(S) URL 或图片 data URI。没有参考图时不要传该字段。 |
| input.quality | string | 否 | medium | low、medium 或 high,决定每个 SVG 的价格。 |
| input.n | integer | 否 | 1 | SVG 文件数量,整数 1–8。 |
| input.size | string | 否 | auto | 画幅比例: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。 |
响应字段
提交响应返回任务标识;状态响应在任务结束时提供结果文件或失败信息。
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 业务返回码,0 或 200 表示成功。 |
| message | string | 可选的人类可读响应信息。 |
| data.task_id | string | 提交成功后用于查询状态的唯一任务 ID。 |
| data.status | string | not_started、running、finished 或 failed。 |
| data.created_time | string | 任务创建时间。 |
| data.progress | integer | 状态响应中的 0–100 进度值。 |
| data.files[] | array | finished 时按返回顺序排列的生成文件。 |
| data.files[].file_url | string | 生成文件(.svg)的直接 URL。 |
| data.files[].file_type | string | 结果文件类型为 image。 |
| data.error_message | string | null | failed 状态的可读失败原因。 |
任务生命周期
只有前两个状态可继续轮询;finished 与 failed 均为终态。
not_started已接收并排队,等待执行。
running正在生成,可以继续轮询。
finished成功终态,验证 files 并读取文件 URL。
failed失败终态,读取 error_message 并停止;预扣积分会全部退还。
轮询与错误处理
- 认证使用有效的 VIDGO_API_KEY,将密钥保存在服务端,并通过 Bearer 认证发送请求。
- 参数校验400 表示模型 ID、字段、枚举、长度、数量或尺寸不符合本端点契约,包括传入其他端点的字段。
- 轮询间隔从 2–5 秒开始;对 429 和 5xx 使用指数退避,并设置总超时。
- 终态finished 后读取 files 中的文件 URL;failed 后读取 error_message。两种状态均结束轮询。
- 回调在顶层提供公开 callback_url;服务会在 finished 或 failed 后 POST 任务对象。
- 网络错误区分请求超时、网络失败和任务失败;仅在安全时重试同一查询。
模型规格
| 规格 | 取值 | 说明 |
|---|---|---|
| 模型 | ideogram/vector-1.0/text-to-vector | Ideogram Vector 1.0 Text to Vector |
| 输入 | prompt + 可选 image_urls(1–5 张) | 提示词最多 9,500 字符 |
| 输出 | SVG 文件 × n(1–8) | files[] 中的 image/svg+xml URL |
| quality | low / medium / high | 每个 SVG 26 / 32 / 40 积分;high + 参考图 64 |
| size | auto + 17 种比例 | 默认 auto |
相关模型
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。















