生成图像

在给定提示的情况下创建图像。了解更多。

Request Body

application/json

model*string

模型名。本网关必填（官方接口可省略），缺失直接返回 model is required

prompt*string

图像描述。GPT image 系列最长 32000 字符，dall-e-3 为 4000，dall-e-2 为 1000

n?integer

生成数量。网关侧允许 1–128，缺省或传 0 时按 1 处理；实际上限以上游模型为准（OpenAI 官方为 1–10，dall-e-3 仅支持 1）

Range1 <= value <= 128

size?string

输出尺寸，格式宽x高。网关会按模型校验：dall-e-2 仅 256x256 / 512x512 / 1024x1024（缺省 1024x1024），dall-e-3 仅 1024x1024 / 1024x1792 / 1792x1024（缺省 1024x1024），GPT image 系列不做限制。注意必须用小写字母 x，写成全角乘号 × 会被拒绝

quality?string

画质档位。GPT image 用 low / medium / high / auto（网关缺省填 auto）；dall-e-3 用 standard / hd（网关缺省填 standard）

background?string

背景处理，仅 GPT image 系列支持。transparent 需搭配 png 或 webp 输出

Value in"transparent" | "opaque" | "auto"

output_format?string

输出图片格式，仅 GPT image 系列支持

Value in"png" | "jpeg" | "webp"

output_compression?integer

压缩率 0–100，仅 GPT image 系列且输出为 webp / jpeg 时有效

Range0 <= value <= 100

moderation?string

内容审核强度，仅 GPT image 系列支持。low 更宽松，auto 为默认

Value in"low" | "auto"

response_format?string

返回形式，仅 dall-e-2 / dall-e-3 支持。url 链接仅 60 分钟内有效；GPT image 系列固定返回 base64

Value in"url" | "b64_json"

style?string

风格，仅 dall-e-3 支持。vivid 更戏剧化，natural 更写实

Value in"vivid" | "natural"

stream?boolean

是否流式返回中间结果，仅 GPT image 系列支持

partial_images?integer

流式模式下返回的中间图数量，0–3

Range0 <= value <= 3

watermark?boolean

是否添加水印。本网关扩展字段，供支持该能力的上游（如国内厂商）使用，OpenAI 官方接口没有此参数

user?string

终端用户标识，便于排查滥用

user_id?string

终端用户标识的别名。本网关扩展字段

extra_fields?object

透传给上游的额外参数。本网关扩展字段，用于使用某些厂商的私有参数

Response Body

application/json

curl -X POST "https://jiniu.ai/v1/images/generations" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "一只戴着宇航头盔的柴犬，等距视角，柔和光照"
  }'

curl -X POST "https://jiniu.ai/v1/images/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "gpt-image-1",    "prompt": "一只戴着宇航头盔的柴犬，等距视角，柔和光照"  }'

{
  "created": 0,
  "data": [
    {
      "url": "string",
      "b64_json": "string",
      "revised_prompt": "string"
    }
  ]
}

Request Body

Response Body

200application/json

application/json