关于 Ideogram Vector 1.0
用一句话或一张图出 SVG 矢量,文字干净。
在 POST /jobs/createTask 里把模型名写成 ideogram/vector-1/edit 即可调用,US$0.132 起。
简介
图片转 SVG 接收一张位图,返回一个矢量文件。发送 logo 截图、图标 PNG 或照片,即可得到可缩放、可改色、可编辑的 SVG。
主要特点
可编辑的路径
输出由 path 元素和渐变构成,不嵌入图片。每个颜色区域都是独立的形状。
两档细节设置
Detailed 尽量贴合原图;Simple 会合并小的区域,适合风格化的画面和更轻的文件。
无需提示词
图片本身就是完整的请求,矢量结果保持原有比例。
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
detail_level | 否 | 选 detailed 保留更细的形状,simple 把形状合并成更少、更大的块。两者价格相同。 detailed · simple · 默认值: detailed |
image_url | 是 | 作为起点的那张图。 |
价格
价格以美元计。API 使用独立的美元余额。网站积分不能用于 API,也不能转入 API 余额;API 余额同样不能转为网站积分。 任务受理时,从 API 余额中冻结报价的最高金额;完成后按实际用量结算,实扣不超过冻结额,并释放剩余金额。任务失败则释放冻结额。
| 选项 | USD /张 |
|---|---|
| 标准 | US$0.132 |
运行前,将相同请求体发送到 POST /jobs/quote,可查看预计费用和最高费用,单位为美元。报价不会运行任务或扣款。
适用场景
低分辨率 logo
把一张小的 PNG logo 转成矢量,用于招牌、印刷和周边商品。
图标集
把位图图标转成 SVG,让它们在应用和网站上保持清晰。
提示词指南与进阶技巧
使用干净的原图
尽量使用你手里最大、最清晰的版本,最好背景纯色。压缩痕迹会变成多余的形状。
风格化作品选 Simple
如果 Detailed 的结果里有太多细碎的形状,改用 Simple 获得更大的区域和更小的文件。
照片的文件可能很大
整张照片可能生成数千条路径,文件达 1–2 MB;图标通常只有几 KB。
API 快速上手
三步调用 Ideogram Vector 1.0 API
- 创建 API 密钥. 登录 PopNow,在 API 控制台创建密钥。密钥以 sk-popnow- 开头,API 调用使用独立的美元余额。
- 发送请求. 向 POST /jobs/createTask 发请求,model 填 ideogram/vector-1/edit,input 按参数表填写。响应会立刻返回任务 ID。
- 取回结果. 用任务 ID 轮询 GET /jobs/recordInfo,或者传 callBackUrl,结果会推送到这个地址。任务成功后下载输出链接。
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "ideogram/vector-1/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"detail_level": "detailed"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"请替换为自己的提示词与素材链接。响应格式、轮询与回调说明请参阅 API 页签。
Ideogram Vector 1.0 API 常见问题
Ideogram Vector 1.0 API 怎么收费?
Ideogram Vector 1.0:最便宜的任务是图片转 SVG,US$0.132/张起。API 使用独立的美元余额。网站积分不能用于 API,也不能转入 API 余额;API 余额同样不能转为网站积分。 任务受理时,从 API 余额中冻结报价的最高金额;完成后按实际用量结算,实扣不超过冻结额,并释放剩余金额。任务失败则释放冻结额。
Ideogram Vector 1.0 在 API 里的调用名是什么?
在 POST /jobs/createTask 的 model 字段里填 图片转 SVG用 ideogram/vector-1/edit;SVG 生成器用 ideogram/vector-1/text-to-image。
Ideogram Vector 1.0 API 有哪些限制?
单个文件大小上限:50 MB。超出这些限制的请求会在扣费之前被拒绝。
不写代码能试 Ideogram Vector 1.0 吗?
无需 API 密钥,即可在 Playground 用 API 美元余额运行 Ideogram Vector 1.0。每次运行记入开发者历史,并附对应代码。