curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "ideogram/v4.5/text-to-image",
"input": {
"prompt": "A retro travel poster for \"LISBON 1932\", tram climbing a sunny hill, bold art deco lettering",
"n": 1,
"quality": "medium",
"size": "3:4"
}
}
'
{
"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 4.5 文生图
Ideogram 4.5 文生图 API 每次请求可生成 1–8 张海报、Logo 和含文字的图片，支持 low、medium、high 三档质量和 42 种尺寸。
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/v4.5/text-to-image",
"input": {
"prompt": "A retro travel poster for \"LISBON 1932\", tram climbing a sunny hill, bold art deco lettering",
"n": 1,
"quality": "medium",
"size": "3:4"
}
}
'
{
"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/v4.5/text-to-image — Ideogram 4.5 文生图，每次请求 1–8 张。
功能
- 文生图，擅长准确渲染画面中的文字（标题、标语、标签）。
- 通过
n每次生成 1–8 张。 - 三档质量：
low、medium、high。 - 六种宽高比预设，外加 36 种精确像素尺寸，从 720x1280 到 3328x1248，以及 2048x2048。
必填参数
prompt（string）：想要的画面，1–10,000 个字符。需要出现的文字请用引号标出，例如"GRAND OPENING"。不能为空白。
可选参数
n（integer）：图片张数，1–8。默认1。quality（string）：low、medium或high。默认medium。size（string）：输出尺寸。默认1:1 HD。见尺寸。
尺寸
- 预设：
1:1、1:1 HD、4:3、3:4、16:9、9:16。1:1 HD为更高分辨率的方形。 - 精确像素尺寸：
720x1280、720x1440、800x1280、832x1248、864x1152、896x1120、1024x1024、1024x3072、1120x896、1152x864、1152x2944、1248x832、1248x3328、1280x720、1280x800、1280x3072、1296x3168、1440x720、1440x2560、1440x2880、1600x2560、1664x2496、1728x2304、1792x2240、2048x2048、2240x1792、2304x1728、2496x1664、2560x1440、2560x1600、2880x1440、2944x1152、3072x1024、3072x1280、3168x1296、3328x1248。 - 其他取值会返回 400。
输出
任务完成后，查询任务状态和回调内容的files 数组中会按请求的张数（n）返回对应数量的图片文件。
示例
- 带文字的海报：旅行海报，标题文字在提示词中用引号标出，
3:4，medium质量。 - 四个高质量 Logo 方案，带回调：
n: 4，quality: high，1024x1024，并提供callback_url。
注意事项
- 本 ID 只接受文本。要修改已有图片，请用 Ideogram 4.5 图像编辑。
- 上文未列出的字段会返回 400。
model和callback_url放在请求根级，不要放进input。 - 积分在提交时预扣，只取决于
quality和n，size不影响价格。任务失败会全额退还。当前费率见定价页。
授权
所有 API 接口都需要 Bearer Token 认证
获取 API Key：
进入 仪表盘 → API 密钥（API Key 管理页面）获取你的 API Key
在请求头中添加：
Authorization: Bearer VIDGO_API_KEY
请求体
application/json