生成图片（文生图）
POST
/v1/images/generations
参数说明
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型名，如 gpt-image-2、gpt-image-1 |
prompt | string | 是 | 图片描述。中文、英文均支持 |
n | integer | 否 | 生成数量，仅支持 1 |
size | string | 否 | 图片尺寸，如 1024x1024（1:1）、1792x1024（16:9）、1024x1792（9:16）、1536x1024（3:2）、2048x2048（2K）、3072x2048（2K 3:2） |
resolution | string | 否 | 显式指定分辨率档位，取值 512/1K/2K/4K（1024/2048/4096 亦可）。优先级高于 size |
quality | string | 否 | 画质: standard（标准）或 hd（高清） |
response_format | string | 否 | 返回格式: url（默认，图片 URL）或 b64_json（base64 编码） |
images | array[string] | 否 | 参考图列表（URL 或 data URI），最多 7 张，用于图生图场景 |
image | string | 否 | 单张参考图（URL 或 base64 data URI），与 images 二选一 |
background | object | 否 | 背景设置 |
output_format | string | 否 | 输出图片格式，如 png、jpeg |
output_compression | object | 否 | 输出压缩设置 |
input_fidelity | object | 否 | 输入保真度，控制参考图保留程度 |
watermark | boolean | 否 | 是否添加水印 |
extra_fields | object | 否 | 额外透传字段 |
请求示例
{"model":"gpt-image-2","prompt":"a cute cat, digital art","n":1,"size":"1024x1024"}响应示例
{"created":1780043639,"data":[{"url":"https://...","b64_json":"...","revised_prompt":""}]}错误响应
| HTTP 状态 | Code | 说明 |
|---|---|---|
| 400 | invalid_request | 请求参数错误（prompt 缺失等） |
| 401 | unauthorized | API Key 无效或缺失 |
| 429 | rate_limited | 同步接口并发超限（默认上限 100） |
| 502 | vidu_image_error | Vidu 上游返回错误码（err_code） |
| 504 | vidu_image_timeout | 异步任务轮询超时（10 分钟） |
请求参数
Header 参数
Body 参数application/json必填
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://aiapi114.com/v1/images/generations' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"background": [
0
],
"extra_fields": [
0
],
"image": [
0
],
"images": [
0
],
"input_fidelity": [
0
],
"mask": [
0
],
"model": "gpt-image-1",
"moderation": [
0
],
"n": 1,
"output_compression": [
0
],
"output_format": [
0
],
"partial_images": [
0
],
"prompt": "一只在花园里弹钢琴的橘猫，水彩风格",
"quality": "standard",
"response_format": "url",
"size": "1024x1024",
"style": [
0
],
"user": [
0
],
"user_id": [
0
],
"watermark": true,
"watermark_enabled": [
0
]
}'响应示例响应示例
200 - 示例 1
{
"created": 0,
"data": [
{
"b64_json": "string",
"revised_prompt": "string",
"url": "string"
}
],
"metadata": [
0
]
}