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/text-to-vector",
"input": {
"prompt": "Flat line icon set of a rocket, a planet and a star, two-colour navy and coral",
"quality": "medium",
"n": 2,
"size": "1:1"
}
}
'
{
"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 根据提示词生成 1–8 个 SVG 文件，支持最多 5 张参考图、18 种宽高比选项和三档质量。
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/text-to-vector",
"input": {
"prompt": "Flat line icon set of a rocket, a planet and a star, two-colour navy and coral",
"quality": "medium",
"n": 2,
"size": "1:1"
}
}
'
{
"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，都可以通过统一的查询任务状态接口获取结果。
模型
- ideogram/vector-1.0/text-to-vector — Ideogram Vector 1.0 文本生成 SVG，每次请求 1–8 个文件。
功能
- 文本生成 SVG：原生矢量输出（
image/svg+xml），不是对位图的描摹。 - 可选 1–5 张参考图，第一张为主要参考。
- 18 种宽高比选项，从竖长的
1:4到横宽的4:1，另有auto。 - 三档质量，每次请求 1–8 个 SVG 文件。
必填参数
prompt（string）：想要的作品，1–9,500 个字符。需要的文字请用引号标出，例如"TRAILHEAD"。不能为空白。
可选参数
image_urls（string[]）：1–5 张参考图（公开 HTTP(S) URL 或图片 data URI）。没有参考图时不要传该字段。quality（string）：low、medium或high。默认medium。n（integer）：SVG 文件数量，1–8。默认1。size（string）：宽高比。默认auto。见尺寸。
尺寸
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。
输出
任务完成后，查询任务状态和回调内容的files 数组中会返回 SVG 文件（image/svg+xml），可直接在矢量编辑软件中打开，或嵌入网页使用。
示例
- 仅提示词生成 SVG 图标：两套方形图标，
medium质量。 - 带风格参考图的横幅，带回调：
3:1横幅，文字用引号标出，一张品牌参考图，quality: high，并提供callback_url。
注意事项
- 要把已有的位图（PNG、JPG）转换为 SVG，请用 Ideogram Vector 1.0 图片转 SVG。
image_urls为空数组或超过五张会返回 400。上文未列出的字段会返回 400。model和callback_url放在请求根级，不要放进input。- 积分在提交时预扣，取决于
quality和n。quality: high且传入image_urls时按更高的单文件费率计费；low和medium有无参考图价格相同。任务失败会全额退还。当前费率见定价页。
授权
所有 API 接口都需要 Bearer Token 认证
获取 API Key：
进入 仪表盘 → API 密钥（API Key 管理页面）获取你的 API Key
在请求头中添加：
Authorization: Bearer VIDGO_API_KEY
请求体
application/json