Images Generations 图片生成

根据文本描述生成图片，支持多种图片生成模型（通义万相、FLUX 等）。采用异步任务模式，提交后返回任务 ID，通过任务查询接口获取最终图片。

接口地址
POST /api/openai/imagesGenerations

请求头 Headers

名称	是否必须	说明
Authorization	是	Bearer API_KEY
Content-Type	是	application/json

请求参数

参数	类型	必填	说明
model	string	是	图片生成模型名称，见下方支持模型
prompt	string	是	图片描述内容，越详细效果越好
negative_prompt	string	否	反向提示词，描述不希望出现的元素
size	string	否	图片尺寸，如 1024*1024，默认使用模型默认尺寸
n	int	否	期望生成数量（上游柔性处理），最终以实际生成的图片张数计费

请求示例

{
  "model": "wanx2.1-t2i-turbo",
  "prompt": "未来城市夜景，赛博朋克风格，高清细节",
  "negative_prompt": "模糊、低质量、水印",
  "size": "1024*1024",
  "n": 1
}

cURL 示例

curl https://api.hejushuzi.com/api/openai/imagesGenerations \
-H "Authorization: Bearer sk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
  "model": "wanx2.1-t2i-turbo",
  "prompt": "未来城市夜景，赛博朋克风格，高清细节",
  "size": "1024*1024",
  "n": 1
}'

成功返回

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": 15,
    "status": "pending"
  }
}

任务创建成功后，接口返回 task_id，需调用 Images Task 图片任务查询 接口轮询获取最终图片地址。

图片编辑（参考图输入）

支持图片编辑能力的模型（qwen-image-3.0、qwen-image-3.0-pro、wan2.7-image、wan2.7-image-pro）可通过 image_url（或 image_urls 数组）传入参考图，再结合 prompt 进行局部编辑 / 重绘。平台会自动将参考图透传给上游模型。单次图生图 最多支持 3 张参考图。

{
  "model": "qwen-image-3.0-pro",
  "prompt": "把背景改为晚霞，保留人物主体",
  "image_url": "https://example.com/portrait.jpg",
  "size": "1024*1024"
}

支持模型

以下为常用推荐模型，完整清单与单价以控制台实时报价为准：

模型	说明	图片编辑
wanx2.1-t2i-turbo	通义万相 Turbo · 高速	—
wanx2.1-t2i-plus	通义万相 Plus · 高质量	—
wan2.2-t2i-plus	通义万相 2.2 Plus · 旗舰	—
wan2.2-t2i-flash	通义万相 2.2 Flash · 极速	—
qwen-image-3.0	Qwen Image 3.0	✔
qwen-image-3.0-pro	Qwen Image 3.0 Pro	✔
wan2.7-image	Wan 2.7 Image	✔
wan2.7-image-pro	Wan 2.7 Image Pro · 专业	✔
Doubao-Seedream-5.0-pro	火山 Seedream 5.0 Pro	—
Doubao-Seedream-5.0-lite	火山 Seedream 5.0 Lite	—

计费说明

计费方式：按实际生成的图片张数计费（提交时校验余额 > 0，任务成功后才实际扣费）
费用 = 实际生成图片数量 × 模型单价（部分模型按 1K/2K 分辨率分档）
任务失败不扣费
最终计费数量以上游实际返回的图片数量为准

错误码

code	说明
400	参数错误（如 model/prompt 缺失、size 格式错误等）
401	API Key 无效或已过期
402	账户余额 / 令牌额度不足
403	非图片生成模型
404	模型不存在
500	图片生成服务内部错误

错误返回示例

{ "code": 400, "msg": "model required" }
{ "code": 401, "msg": "无效的API令牌" }
{ "code": 402, "msg": "账户余额不足，请充值后使用" }
{ "code": 403, "msg": "Model is not image model" }
{ "code": 500, "msg": "Image generate failed" }