curl https://sub.vcnovb.cn/v1/images/generations \
-H "Authorization: Bearer $VC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-image-2","prompt":"极简风格的山间木屋,晨雾,柔和自然光","n":1,"size":"1024x1024"}'
curl https://sub.vcnovb.cn/v1/images/edits \
-H "Authorization: Bearer $VC_API_KEY" \
-F 'model=gpt-image-2' \
-F 'prompt=保留主体,将背景改为海边日落' \
-F 'image=@reference.png'
图像与视频 API
图片生成与编辑
使用支持图片能力的分组生成或编辑图片,按模型选择参数与响应格式。
POST
https://sub.vcnovb.cn
/
v1
/
images
/
generations
curl https://sub.vcnovb.cn/v1/images/generations \
-H "Authorization: Bearer $VC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-image-2","prompt":"极简风格的山间木屋,晨雾,柔和自然光","n":1,"size":"1024x1024"}'
curl https://sub.vcnovb.cn/v1/images/edits \
-H "Authorization: Bearer $VC_API_KEY" \
-F 'model=gpt-image-2' \
-F 'prompt=保留主体,将背景改为海边日落' \
-F 'image=@reference.png'
按模型查看完整参数与多语言示例:GPT Image 生成、图片编辑、Grok Image。
结果链接请及时下载保存。
支持独立图片任务的分组也可能返回任务对象。遇到异步结果时,按返回的查询地址处理,见图片异步任务。
curl https://sub.vcnovb.cn/v1/images/generations \
-H "Authorization: Bearer $VC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-image-2","prompt":"极简风格的山间木屋,晨雾,柔和自然光","n":1,"size":"1024x1024"}'
curl https://sub.vcnovb.cn/v1/images/edits \
-H "Authorization: Bearer $VC_API_KEY" \
-F 'model=gpt-image-2' \
-F 'prompt=保留主体,将背景改为海边日落' \
-F 'image=@reference.png'
调用条件
Key 所属分组需要开放图片生成权限,并且包含目标图片模型。支持图片的 OpenAI、Grok 等分组有不同参数范围;Gemini 原生图片模型请查看Gemini 接口。图片模型 ID,例如
gpt-image-2。可用型号见模型列表。读取结果
| 字段 | 说明 |
|---|---|
data[].url | 图片下载地址 |
data[].b64_json | Base64 编码的图片数据,解码后保存为图片文件 |
参考图注意事项
multipart 请求由 cURL 自动生成 Content-Type 边界,不要手动覆盖为 JSON。示例中的reference.png 必须是本地存在的图片文件。
参考图数量、格式及尺寸要求见对应模型的编辑接口说明。