---
title: 图片生成与编辑
description: 使用支持图片能力的分组生成或编辑图片，按模型选择参数与响应格式。
api: "POST /v1/images/generations"
---

按模型查看完整参数与多语言示例：[GPT Image 生成](/models/image/generation)、[图片编辑](/models/image/edit)、[Grok Image](/models/image/grok)。

<RequestExample>
```bash 图片生成
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"}'
```
```bash 图片编辑 · multipart
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'
```
</RequestExample>

## 调用条件

Key 所属分组需要开放图片生成权限，并且包含目标图片模型。支持图片的 OpenAI、Grok 等分组有不同参数范围；Gemini 原生图片模型请查看[Gemini 接口](/api/gemini)。

<ParamField body="model" type="string" required>图片模型 ID，例如 `gpt-image-2`。可用型号见[模型列表](/api/models)。</ParamField>
<ParamField body="prompt" type="string" required>描述主体、构图、风格和修改要求。</ParamField>
<ParamField body="n" type="integer">生成数量，使用正整数。数量上限见对应模型说明。</ParamField>
<ParamField body="size" type="string">输出尺寸或分辨率档位，格式见对应模型的参数说明。</ParamField>

## 读取结果

| 字段 | 说明 |
| --- | --- |
| `data[].url` | 图片下载地址 |
| `data[].b64_json` | Base64 编码的图片数据，解码后保存为图片文件 |

结果链接请及时下载保存。

支持独立图片任务的分组也可能返回任务对象。遇到异步结果时，按返回的查询地址处理，见[图片异步任务](/api/image-tasks)。

## 参考图注意事项

multipart 请求由 cURL 自动生成 Content-Type 边界，不要手动覆盖为 JSON。示例中的 `reference.png` 必须是本地存在的图片文件。

参考图数量、格式及尺寸要求见对应模型的编辑接口说明。