POSThttps://api.wylon.cn/v1/images/generations

同步生成

通过 OpenAI Images 兼容接口生成图片，并在同一次响应中取得短时效图片地址。

鉴权与请求格式

Authorizationstring · header必填

Bearer 令牌。可前往控制台创建 API 密钥，并将其保存为环境变量 $WYLON_API_KEY。

Content-Typestring · header必填

固定为 application/json。

请求参数

modelstring必填

wylon 提供的模型 ID，例如 Qwen/Qwen-Image-2512。可前往模型广场或通过列出模型确认可访问的模型。

promptstring必填

描述希望生成的主体、场景、构图、光线、风格和文字内容。

negative_promptstring可选

描述不希望出现在生成结果中的内容。是否支持、长度限制及实际效果由所选模型决定。

sizestring可选

期望输出的图片尺寸，格式为 宽x高。省略时使用所选模型的默认值；支持的取值由模型决定。

ninteger1

请求生成的图片数量。省略时使用所选模型的默认值；支持范围由接口版本和模型能力共同决定。

response_formatstringurl

指定图片结果在响应中的交付方式，可使用 url 或 b64_json。本文示例使用已经验证的 url 方式。

output_formatstringpng

期望生成的图片文件格式。V1 仅支持png格式

output_compressioninteger可选

期望使用的输出压缩等级，对 png 图片默认不生效。

backgroundstring可选

期望使用的图片背景模式。Openai兼容字段，V1 默认不生效。

qualitystring可选

期望使用的图片质量档位。是Openai兼容字段，V1 默认不生效。

stylestring可选

期望使用的图片风格预设。是否支持及合法取值由所选模型决定。

userstring可选

调用方提供的终端用户关联标识。该字段不参与 API 鉴权。

user_idstring可选

兼容性用户标识。接口接受该字段，但当前不持久化或使用。

moderationstring可选

请求使用的内容审核模式。该字段不能关闭或绕过平台安全策略。

streambooleanfalse

是否流式返回生成过程中的部分图片。V1 不支持该能力，请省略或传入 false。

partial_imagesinteger0

指定流式生成时返回的部分图片数量。V1 不支持该能力，请省略或传入 0。

当前模型限制

以下取值仅适用于 Qwen/Qwen-Image-2512，不能作为其他图片模型的默认参数。

参数	支持值	默认值	说明
`size`	`1328x1328`、`1664x928`、`928x1664`、`1104x1472`、`1584x1056`	`1664x928`	支持方形、横向和纵向画幅
`n`	`1`	`1`	每次仅生成一张图片

无论选择哪个图片模型，V1 都会添加“AI 生成”水印，且不支持流式中间图。以上属于接口版本行为，不属于单个模型的能力参数。

响应结构

成功响应

{
  "created": 1788834007,
  "data": [
    { "url": "https://example.com/generated/image.png?signature=REDACTED" }
  ]
}

data[0].url 是短时效签名地址。收到响应后请尽快下载或转存。

错误结构

{
  "error": {
    "type": "invalid_request_error",
    "message": "Invalid image generation request.",
    "code": "invalid_parameter"
  }
}

错误处理与生产建议

状态码	常见原因	建议操作
`400`	字段缺失或模型不支持相应参数	根据当前模型限制修正请求
`401`、`403`	密钥无效或没有模型权限	检查鉴权和账户权限
`429`	触发频率、并发或容量限制	等待后重新发起请求
`500`、`503`	服务内部异常或模型暂不可用	确认调用结果后再决定是否创建新请求
`504`	等待期限内没有可交付结果	不要默认自动重试，先确认实际用量状态