用户指南
生图模型

Qwen Image 图像生成

通过 `/v1/images/generations` 调用 Qwen Image 系列;当前项目按同步图片接口返回 `ImageResponse`,不使用 task_id 轮询。

  • 路由:POST /v1/images/generations
  • 成功后同步返回 ImageResponse

推荐请求示例

curl --request POST \
  --url https://api.magickapi.com/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "qwen-image",
    "prompt": "一只可爱的橘猫在阳光下打瞌睡",
    "n": 1,
    "response_format": "url",
    "parameters": {
      "size": "1024*1024",
      "watermark": false
    }
  }'

成功响应示例

{
  "created": 1712345678,
  "data": [
    {
      "url": "https://example.com/generated-image.png",
      "b64_json": "",
      "revised_prompt": ""
    }
  ]
}

错误响应示例

{
  "error": {
    "message": "Invalid request",
    "type": "invalid_request_error",
    "param": null,
    "code": "invalid_request"
  }
}

可确认的字段

标准图片字段

当前项目公开图片接口保证以下标准字段可用:

  • model
  • prompt
  • n
  • size
  • quality
  • response_format

Qwen / 阿里扩展字段

如果你需要使用阿里兼容扩展,请使用嵌套对象,而不是旧版文档里的顶层扩展字段:

  • parameters
  • input

例如:

{
  "model": "qwen-image",
  "prompt": "赛博朋克城市夜景",
  "parameters": {
    "size": "1536*1024",
    "n": 2,
    "watermark": false
  }
}

兼容说明

  • 图像编辑请改用 /v1/images/edits/v1/edits

最后更新于

目录