API 目录

创建绘画

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-***

请求体

参数类型必填说明
modelstring用于图像生成的模型名称。
promptstring图像生成提示词,用于描述期望生成的画面内容。
ninteger要生成的图片数量。
sizestring生成图片的尺寸,例如 1024x1024
qualitystring图片质量设置,具体可用值取决于所选模型。
stylestring图片风格设置,具体可用值取决于所选模型。
response_formatstring返回图片的格式,例如 urlb64_json
userstring终端用户标识,可用于请求追踪与安全审计。

请求示例

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..."
    }
  ]
}

响应字段

字段类型说明
createdinteger结果创建时间,Unix 时间戳。
dataarray生成图片结果列表。
data[].urlstring图片访问地址。当返回格式为 url 时出现。
data[].b64_jsonstringBase64 编码的图片内容。当返回格式为 b64_json 时出现。