curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "ideogram-vector-1.0/text-to-vector",
"input": {
"prompt": "A playful cat logo with bold outlines and flat colors"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1792468800-example",
"status": "not_started",
"created_time": "2026-11-03T06:00:00"
}
}{
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}Ideogram
Ideogram Vector 1.0
根据提示词生成 SVG 矢量图，最多可带五张参考图，或把一张图片转换成 SVG。
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "ideogram-vector-1.0/text-to-vector",
"input": {
"prompt": "A playful cat logo with bold outlines and flat colors"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1792468800-example",
"status": "not_started",
"created_time": "2026-11-03T06:00:00"
}
}{
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}- 提交后会返回
task_id。如果提供了callback_url，当任务状态变为finished或failed时，系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url，都可以通过统一的查询任务状态接口获取结果。
模型
- ideogram-vector-1.0/text-to-vector — 根据提示词生成 SVG，可选参考图
- ideogram-vector-1.0/image-to-vector — 把恰好一张图片转换成 SVG
功能
- 根据提示词生成 1–8 张 SVG，可控制质量和宽高比。
- 文生矢量可在
image_urls中带 1–5 张参考图。第一张是主参考图。 - 把恰好一张 JPEG、PNG 或 WebP 图片转换成 SVG，可选保留细节或使用更少图形。
必填参数
prompt(string)：ideogram-vector-1.0/text-to-vector必填。使用 1–9500 个字符，且须包含非空白文本。image_urls(array of strings)：ideogram-vector-1.0/image-to-vector必填。恰好一个可公开访问的 HTTP(S) 图片 URL，用于转换成 SVG。支持 JPEG、PNG 或 WebP，最大 50 MB。
可选参数
image_urls(array of strings)：ideogram-vector-1.0/text-to-vector可选。1–5 个可公开访问的 HTTP(S) 参考图。支持 JPEG、PNG 或 WebP，每张最大 10 MB。第一个 URL 是主参考图。没有参考图时不要传这个字段。quality(string)：仅文生矢量。low、medium或high。默认为medium。n(integer)：仅文生矢量。SVG 数量，1 到 8。默认为 1。size(string)：仅文生矢量。宽高比。默认为auto。mode(string)：仅图片转矢量。default保留更多细节。simple使用更少图形。默认为default。
尺寸
文生矢量接受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。
图片转矢量不接受 size。
输出
完成的任务返回 SVG 文件。每个文件的file_type 为 image。
示例
OpenAPI 示例包含文生矢量、带参考图的文生矢量，以及单图转矢量。注意事项
- 按任务选择模型 ID。文生矢量不接受
mode。图片转矢量不接受prompt、quality、n或size。 - 文生矢量里的
image_urls是参考图。图片转矢量里的image_urls是要转换的那一张图片。 - 生成参数放在
input内。callback_url属于请求顶层。
授权
所有 API 接口都需要 Bearer Token 认证。
创建 API Key：登录 PoYo，进入 仪表盘 → API 密钥（poyo.ai/zh/dashboard/api-key），点击创建 Key。
在请求头中添加：
Authorization: Bearer PoYo_API_KEY
请求体
application/json
响应
任务提交成功
Show child attributes
Show child attributes