创建绘画
POST/v1/images/generations 创建图像
POST https://www.vortapapi.com/v1/images/generations
根据输入的文本提示生成一张或多张图像。该接口兼容 OpenAI API 的图像生成请求格式,可通过模型、提示词、图片数量、尺寸等参数控制生成结果。
请求头
| 名称 | 必填 | 说明 |
|---|---|---|
Content-Type | 是 | 固定为 application/json |
Accept | 是 | 建议设置为 application/json |
Authorization | 是 | 使用 Bearer Token 鉴权,例如:Bearer sk-*** |
请求体
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 用于图像生成的模型名称。 |
prompt | string | 是 | 图像生成提示词,用于描述期望生成的画面内容。 |
n | integer | 否 | 要生成的图片数量。 |
size | string | 否 | 生成图片的尺寸,例如 1024x1024。 |
quality | string | 否 | 图片质量设置,具体可用值取决于所选模型。 |
style | string | 否 | 图片风格设置,具体可用值取决于所选模型。 |
response_format | string | 否 | 返回图片的格式,例如 url 或 b64_json。 |
user | string | 否 | 终端用户标识,可用于请求追踪与安全审计。 |
请求示例
curl https://www.vortapapi.com/v1/images/generations \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer sk-***" \
-d '{
"model": "gpt-image-1",
"prompt": "一只穿着宇航服的橘猫站在月球表面,背景是地球,电影感光照",
"n": 1,
"size": "1024x1024"
}'
响应示例
{
"created": 1713833628,
"data": [
{
"url": "https://example.com/generated-image.png"
}
]
}
如果将 response_format 设置为 b64_json,响应中的图片数据可能以 Base64 字符串返回:
{
"created": 1713833628,
"data": [
{
"b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
}
]
}
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
created | integer | 结果创建时间,Unix 时间戳。 |
data | array | 生成图片结果列表。 |
data[].url | string | 图片访问地址。当返回格式为 url 时出现。 |
data[].b64_json | string | Base64 编码的图片内容。当返回格式为 b64_json 时出现。 |