Sticker Outline For Cutting
Ideogram Vector 1.0 Image to Vector API
ideogram/vector-1.0/image-to-vectorIdeogram Vector 1.0 Image to Vector 将一张位图转为 SVG,提供细节丰富的 default 与形状更少的 simple 模式。它沿用源图形状颜色,让 Logo 与草图可无损缩放。
获取 API Key拖拽文件、粘贴剪贴板素材,或输入 URL。 恰好一张位图(公开 HTTP(S) URL)。
1/1 个素材
预计费用: 20 credits · $0.1000
提交任务时预扣积分,任务失败将全额退还。
示例
REST API
快速开始
以下流程提交一个合法的 Ideogram Vector 1.0 Image 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/image-to-vector",
"input": {
"mode": "default",
"image_urls": [
"https://cdn.vidgo.ai/apis/models/ideogram/vector-1.0/image-to-vector/v1/01/input-01-raster-placeholder.png"
]
}
}'等待结果
读取 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/image-to-vector",
"input": {
"mode": "default",
"image_urls": [
"https://cdn.vidgo.ai/apis/models/ideogram/vector-1.0/image-to-vector/v1/01/input-01-raster-placeholder.png"
]
}
}
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.image_urls | string[] | 是 | – | 恰好一张位图,以包含 1 个公开 HTTP(S) URL 或图片 data URI 的数组提供。 |
| input.mode | string | 否 | default | default 保留更多细节;simple 输出更少、更干净的形状。 |
响应字段
提交响应返回任务标识;状态响应在任务结束时提供结果文件或失败信息。
| 字段 | 类型 | 说明 |
|---|---|---|
| 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/image-to-vector | Ideogram Vector 1.0 Image to Vector |
| 输入 | image_urls(恰好 1 张) | 无提示词 |
| 输出 | 1 个 SVG 文件 | files[] 中的 image/svg+xml URL |
| mode | default / simple | 每次请求固定 20 积分 |
相关模型
Ideogram Vector 1.0 Image to Vector API 常见问题
Ideogram Vector 1.0 Image to Vector API 是什么?
Ideogram Vector 1.0 Image to Vector 是 Ideogram 用于将位图转换为 SVG 矢量文件的模型。它接收一张图片并返回可缩放的矢量形状,提供保留细节的 default 模式与形状更少的 simple 模式。它沿用源图的轮廓和颜色,让 Logo、草图与插画能够以矢量形式缩放和编辑。你可以通过 API 进行程序化调用,也可以在上方体验区直接在线试用。
Ideogram Vector 1.0 Image to Vector 的 default 和 simple 有什么区别?
default 保留更多细节,适合插画;simple 输出更少、更干净的形状,便于切割、绘图或手动编辑。两者价格相同。
Ideogram Vector 1.0 Image to Vector 怎么收费?
两种模式均为每次请求固定 20 积分($0.10),每次请求将一张图片转换为一个 SVG。
哪些图片适合 Ideogram Vector 1.0 Image to Vector?
边缘清晰的主体,例如 Logo、图标、线稿和扁平插画,并配合纯净背景。复杂照片会生成更复杂的文件。
Ideogram Vector 1.0 Image to Vector 可以输入提示词吗?
不可以,端点会按原图进行矢量化。需要修改设计时,可先用 Ideogram 4.5 Edit 编辑位图,或用 Text to Vector 生成新作品。
Ideogram Vector 1.0 Image to Vector 返回什么?
files 中的 SVG 文件 URL(image/svg+xml),可直接在矢量编辑器中打开或嵌入网页。
Ideogram Vector 1.0 Image to Vector 能一次转换多张图片吗?
每次请求只接收一张图片。批量转换时请为每张图片提交一个任务,每个任务 20 积分。















