创建图像（gpt-image-1）

POST https://www.vortapapi.com/v1/images/generations

根据文本提示词生成一张或多张图像。该接口兼容 OpenAI Images API，可用于调用 gpt-image-1 等图像生成模型。

请求头

名称	必填	说明
Content-Type	是	固定为 application/json
Accept	否	建议设置为 application/json
Authorization	是	使用 Bearer Token，例如：Bearer sk-***

请求体参数

参数	类型	必填	说明
model	string	否	要使用的图像模型，例如 gpt-image-1。
prompt	string	是	图像生成提示词，用于描述希望生成的画面内容。
n	integer	否	生成图片数量。默认值通常为 1。
size	string	否	图片尺寸。gpt-image-1 常用值包括 1024x1024、1536x1024、1024x1536、auto。
quality	string	否	图像质量，可使用 auto、high、medium、low。
background	string	否	背景类型，可使用 auto、transparent、opaque。
output_format	string	否	输出图片格式，例如 png、jpeg、webp。
output_compression	integer	否	输出压缩质量，适用于 jpeg 或 webp，取值范围通常为 0 到 100。
moderation	string	否	内容审核强度，例如 auto 或 low。
user	string	否	终端用户标识，可用于追踪和风控。

请求示例

curl https://www.vortapapi.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "一只穿着宇航服的橘猫站在月球表面，背景是蓝色地球，电影感光影",
    "size": "1024x1024",
    "quality": "high",
    "n": 1
  }'

响应示例

gpt-image-1 通常会返回 Base64 编码的图片数据，可从 data[].b64_json 中读取并保存为图片文件。

{
  "created": 1713833628,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ]
}

响应字段

字段	类型	说明
created	integer	响应创建时间，Unix 时间戳。
data	array	生成结果列表。
data[].b64_json	string	Base64 编码后的图片内容。
data[].revised_prompt	string	若模型对提示词进行了改写，可能返回该字段。

保存 Base64 图片示例

import base64
import requests

response = requests.post(
    "https://www.vortapapi.com/v1/images/generations",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer sk-***"
    },
    json={
        "model": "gpt-image-1",
        "prompt": "一座漂浮在云层之上的未来城市，清晨阳光，超写实风格",
        "size": "1024x1024",
        "n": 1
    }
)

result = response.json()
image_base64 = result["data"][0]["b64_json"]

with open("image.png", "wb") as f:
    f.write(base64.b64decode(image_base64))