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/edit",
"input": {
"prompt": "Change the shop sign to read \"OPEN LATE\" in neon pink",
"image_urls": [
"https://example.com/storefront.png"
],
"quality": "medium",
"n": 1,
"size": "auto"
}
}
'
{
"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 根据文字指令编辑一张图片，支持可选蒙版、最多 4 张参考图，以及 regular 或 high 两档编辑精度。
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/edit",
"input": {
"prompt": "Change the shop sign to read \"OPEN LATE\" in neon pink",
"image_urls": [
"https://example.com/storefront.png"
],
"quality": "medium",
"n": 1,
"size": "auto"
}
}
'
{
"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，都可以通过统一的查询任务状态接口获取结果。
high 编辑精度。常见用途包括替换商品或招牌文字、修饰背景、批量制作设计变体。Ideogram 称该模型可以避免多次连续编辑后累积的偏色和瑕疵。
Ideogram 4.5 是 Ideogram 面向文字密集型画面和精确编辑的图像模型。Vidgo 提供两个 model ID：文生图和图像编辑。
模型
- ideogram/v4.5/edit — Ideogram 4.5 图像编辑：一张原图，可选蒙版和参考图。
功能
- 用自然语言指令进行图像编辑，包括替换画面中的文字。
- 可选蒙版，把编辑限定在某个区域。
- 最多 4 张风格或内容参考图（使用蒙版时最多 3 张）。
edit_precision: high适合其余部分必须保持不变的编辑。- 四档质量（含用于低成本草稿的
very_low），每次请求 1–8 张结果。
输入模式
- 指令编辑：
image_urls+prompt，由模型决定修改哪个区域。 - 蒙版编辑：再加
mask_url（黑色为编辑区域，白色为保留区域），并保持size: auto。 - 两种模式都可以加
reference_image_urls。
必填参数
prompt（string）：要改什么、怎么改，1–10,000 个字符。不能为空白。image_urls（string[]）：恰好一张要编辑的图片。公开 HTTP(S) URL 或data:image/...;base64,...格式的 data URI。
可选参数
mask_url（string）：与原图尺寸一致的蒙版，须同时包含黑色（编辑）和白色（保留）。要求size: auto。reference_image_urls（string[]）：最多 4 张参考图；使用mask_url时最多 3 张。参考图只引导结果，本身不会被编辑。edit_precision（string）：regular或high。默认regular。high要求size: auto。quality（string）：very_low、low、medium或high。默认medium。n（integer）：结果张数，1–8。默认1。size（string）：输出尺寸。默认auto。见尺寸。
尺寸
auto（默认）保持原图尺寸。发送mask_url或edit_precision: high时必须使用auto。- 预设：
1:1、1:1 HD、4:3、3:4、16:9、9:16。 - 自定义
WIDTHxHEIGHT，例如1536x1024：每边至少 256 且为 32 的倍数，总像素不超过 4,194,304（2048x2048），宽高比不超过 6:1。
输出
任务完成后，查询任务状态和回调内容的files 数组中会按请求的张数（n）返回对应数量的图片文件。
示例
- 仅文字指令编辑：修改店铺招牌上的文字，
size: auto，medium质量。 - 蒙版编辑，带参考图和高精度：沙发区域蒙版加一张扶手椅参考图，
edit_precision: high，quality: high，并提供callback_url。
注意事项
image_urls必须恰好包含一张图片。要从零生成图片，请用 Ideogram 4.5 文生图。- 使用
mask_url或edit_precision: high时size不是auto会返回 400；蒙版同时搭配 4 张参考图也会返回 400。 - 上文未列出的字段会返回 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