curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gpt-image-2",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A premium product photo of a silver espresso machine on a clean white studio background, realistic lighting, high detail",
"quality": "low",
"size": "1:1",
"resolution": "1K"
}
}
'
{
"code": 200,
"data": {
"task_id": "task-unified-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2026-04-27T10:30:00"
}
}
OpenAI
GPT Image 2
GPT Image 2 API 用于生成和编辑图像。
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": "gpt-image-2",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A premium product photo of a silver espresso machine on a clean white studio background, realistic lighting, high detail",
"quality": "low",
"size": "1:1",
"resolution": "1K"
}
}
'
{
"code": 200,
"data": {
"task_id": "task-unified-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2026-04-27T10:30:00"
}
}
- 提交后会返回
task_id。如果提供了callback_url，当任务状态变为finished或failed时，系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url，都可以通过统一的查询任务状态接口获取结果。
模型
- gpt-image-2 - 根据提示词进行文生图。
- gpt-image-2-edit - 基于一张或多张
image_urls和文字指令进行图像编辑。
概览
使用 Vidgo API 根据提示词生成一张图像，或用自然语言指令编辑一张或多张参考图。GPT Image 2 支持显式的质量档位、比例预设、自定义尺寸，以及1K、2K 或 4K 分辨率控制。
分辨率
resolution 参数控制实际输出分辨率。
| 分辨率 | 说明 |
|---|---|
1K | 标准分辨率 |
2K | 高分辨率 |
4K | 超高分辨率，适用于支持真 4K 的尺寸 |
计费因素
每次请求生成一张图像。计费取决于quality 以及由 size 和 resolution 决定的实际输出分辨率。下面的规则说明实际分辨率如何确定。
分辨率规则
- 如果省略
size或设为auto，即使提供了resolution，请求也按1K处理和计费。 - 自定义
WIDTHxHEIGHT尺寸需要resolution为2K或4K。 - 只有
16:9、9:16、21:9，或某条边为3840像素的自定义尺寸才按4K计费。 - 不满足真 4K 规则的
4K请求按实际的2K档位计费。 - 最长边为
3840的自定义尺寸必须使用resolution: "4K"。
自定义尺寸限制
自定义尺寸使用WIDTHxHEIGHT 格式，例如 2304x1536，并且必须同时满足：
- 宽和高都必须能被
16整除。 - 最长边不超过
3840像素。 - 宽高比不超过
3:1。 - 像素总数在
655,360到8,294,400之间。
请求示例
生成图像
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header "Authorization: Bearer VIDGO_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "gpt-image-2",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A premium product photo of a silver espresso machine on a clean white studio background, realistic lighting, high detail",
"quality": "low",
"size": "1:1",
"resolution": "1K"
}
}'
编辑图像
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header "Authorization: Bearer VIDGO_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "gpt-image-2-edit",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "Replace the background with a clean white studio backdrop and add a soft natural shadow while preserving the product shape",
"quality": "medium",
"size": "1:1",
"resolution": "2K",
"image_urls": [
"https://cdn.vidgo.ai/temp/reference-product.jpg"
]
}
}'
响应流程
提交接口返回task_id、status 和 created_time。如果提供了 callback_url，任务变为 finished 或 failed 时，Vidgo API 会向其发送 POST 请求。
使用统一的状态接口获取最终结果：
curl --request GET \
--url https://api.vidgo.ai/api/generate/status/task-unified-1757165031-uyujaw3d \
--header "Authorization: Bearer VIDGO_API_KEY"
finished 时，状态响应的 data.files 中包含生成的图像文件 URL。任务失败时，状态响应会返回失败详情，便于排查。
注意事项
input.prompt必填，最多4000个字符。input.quality可选：low、medium或high。默认：low。input.size可选。支持的值为auto、1:1、2:3、3:2、3:4、4:3、4:5、5:4、16:9、9:16、21:9，或自定义WIDTHxHEIGHT值。input.resolution可选：1K、2K或4K。gpt-image-2-edit需要input.image_urls。gpt-image-2不接受input.image_urls。- 每次请求返回一张图像。
授权
所有 API 接口都需要 Bearer Token 认证。
在 仪表盘 → API 密钥 页面获取 API Key，并在请求头中传入：
Authorization: Bearer VIDGO_API_KEY
请求体
application/json