Images Generations 图片生成

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

接口地址
POST /api/openai/imagesGenerations

请求头 Headers

名称是否必须说明
AuthorizationBearer API_KEY
Content-Typeapplication/json

请求参数

参数类型必填说明
modelstring图片生成模型名称,见下方支持模型
promptstring图片描述内容,越详细效果越好
negative_promptstring反向提示词,描述不希望出现的元素
sizestring图片尺寸,如 1024*1024,默认使用模型默认尺寸
nint生成数量,默认 1,最大 4

请求示例

{
  "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 图片任务查询 接口轮询获取最终图片地址。

支持模型

模型说明价格
wanx2.1-t2i-turbo通义万相 Turbo · 高速¥0.40 / 张
wanx2.1-t2i-plus通义万相 Plus · 高质量¥0.60 / 张
wanx2.2-t2i-plus通义万相 2.2 Plus · 旗舰¥0.80 / 张
wanx2.2-t2i-flash通义万相 2.2 Flash · 极速¥0.30 / 张
flux-devFLUX Dev · 通用开发版¥0.50 / 张
flux-schnellFLUX Schnell · 极速版¥0.20 / 张

计费说明

  • 计费方式:按生成图片张数计费
  • 费用 = 生成数量(n) × 模型单价
  • 在任务创建时预扣费用,任务失败自动退还
  • 生成数量 n > 1 时,费用按张数成倍计算

错误码

code说明
400参数错误(如 model/prompt 缺失、size 格式错误等)
401API Key 无效或已过期
403账户余额不足
429请求频率超限,请稍后重试
500图片生成服务内部错误

错误返回示例

{ "code": 400, "msg": "Model is required" }
{ "code": 401, "msg": "Invalid API Key" }
{ "code": 403, "msg": "Insufficient balance" }
{ "code": 429, "msg": "Rate limit exceeded" }