curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "ideogram/vector-1.0/image-to-vector",
"input": {
"image_urls": [
"https://example.com/logo.png"
],
"mode": "default"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1762160000-abc123",
"status": "not_started",
"created_time": "2026-11-03T10:30:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Ideogram
Ideogram Vector 1.0 图片转 SVG
Ideogram Vector 1.0 图片转 SVG API 将一张 PNG、JPG 或 WebP 图片转换为可编辑的 SVG 文件,可选 default(细节丰富)或 simple 模式。
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "ideogram/vector-1.0/image-to-vector",
"input": {
"image_urls": [
"https://example.com/logo.png"
],
"mode": "default"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1762160000-abc123",
"status": "not_started",
"created_time": "2026-11-03T10:30:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}- 提交后会返回
task_id。如果提供了callback_url,当任务状态变为finished或failed时,系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url,都可以通过统一的查询任务状态接口获取结果。
default 模式,想要更简洁扁平的效果时选择 simple 模式。无需提示词。
Ideogram Vector 1.0 是 Ideogram 第一个输出矢量图而不是像素图的模型。Vidgo 提供两个 model ID:文本生成 SVG和图片转 SVG。
模型
- ideogram/vector-1.0/image-to-vector — Ideogram Vector 1.0 图片转 SVG:输入一张图片,输出一个 SVG。
功能
- 每次请求将一张图片矢量化为 SVG。
- 两种风格:
default(细节更多)和simple(形状更少)。 - 接受公开 URL 或图片 data URI。
必填参数
image_urls(string[]):恰好一张图片(建议 PNG、JPG 或 WebP)。公开 HTTP(S) URL 或data:image/...;base64,...格式的 data URI。
可选参数
mode(string):default或simple。默认default。
输出
任务完成后,查询任务状态和回调内容的files 数组中会返回 SVG 文件(image/svg+xml),可直接在矢量编辑软件中打开,或嵌入网页使用。
示例
- 以 default 模式矢量化 Logo:一张 PNG Logo,
mode: default。 - simple 模式,带回调:一张 JPG 草图,
mode: simple,并提供callback_url。
注意事项
- 本 ID 不接受
prompt,传入会返回 400。要根据文本生成新的 SVG 作品,请用 Ideogram Vector 1.0 文本生成 SVG。 image_urls必须恰好包含一张图片。上文未列出的字段会返回 400。model和callback_url放在请求根级,不要放进input。- 每次请求按固定单价计费,
mode不影响价格。任务失败会全额退还。当前费率见定价页。
授权
所有 API 接口都需要 Bearer Token 认证
获取 API Key:
进入 仪表盘 → API 密钥(API Key 管理页面)获取你的 API Key
在请求头中添加:
Authorization: Bearer VIDGO_API_KEY
请求体
application/json