简体中文

English

简体中文

English

主题

Qwen 图像生成 ​

与 使用统一文生图入口。
http
POST /v1/images/generations
  • 需要 或 时，推荐直接传原生多模态结构。
  • 只使用基础参数时，也可以传 OpenAI 简化结构。

当前可用模型 ​

请求头 ​

名称类型必填说明
string是请求身份认证。使用 Bearer Token，示例：
string是请求内容类型，必须设置为

请求体 ​

名称类型必填说明
string是固定传 或
string否简化格式使用的生成提示词；传入 时可以不传
object否原生多模态输入结构，包含 。传入时顶层 可以为空； 与顶层 至少提供一个有效文本
object否Qwen 图片生成参数。显式传入后，适配器直接使用其中的参数，不再从顶层复制 、、
string否简化格式输出尺寸，使用 （例如 ）
integer否简化格式输出数量。未传或为 时按 处理
boolean否简化格式水印开关

input.messages 消息项 ​

名称类型必填说明
string是消息角色，固定为
array是消息内容列表。每个内容元素二选一： 或 。文生图只传一个 ；图生图/编辑传 1～3 个 和一个

input.messages.content 内容项 ​

名称类型必填说明
string否文本内容，即生成提示词或编辑要求。文生图必须传且只传一个
string否参考图地址，支持 HTTP/HTTPS URL 或带 MIME 前缀的 Data URL。图生图/编辑时传 1～3 个；格式支持 JPG、JPEG、PNG、BMP、TIFF、WEBP、GIF；官方建议宽高在 384～2048 像素之间；单张不超过 10 MB

parameters ​

名称类型必填说明
string否输出尺寸，原生格式为 （例如 ）。简化格式使用顶层 ，格式为
integer否输出图片数量；上游当前取值范围为 1～6。未传或为 时按 处理
boolean否是否添加水印
boolean否是否开启提示词扩写
integer否随机种子

OpenAI 简化结构 ​

只使用基础参数时，可以直接在顶层传 、、、。适配器会执行以下转换：

  • 将 转换为 。
  • 将 中的 转换为原生格式 。
  • 未传 或 时，将 设置为 。

请求示例 ​

bash
curl --request POST https://octopusx.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "qwen-image-3.0",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          { "text": "一张暖色胶片风格的午后街景人像，人物手捧玫瑰花束，逆光，浅景深" }
        ]
      }
    ]
  },
  "parameters": {
    "prompt_extend": true,
    "size": "1080*1080",
    "n": 1,
    "watermark": false,
    "seed": 123456
  }
}'
bash
curl --request POST https://octopusx.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "qwen-image-3.0",
  "prompt": "一张暖色胶片风格的午后街景人像",
  "size": "1080x1080",
  "n": 1,
  "watermark": false
}'

响应示例 ​

json
{
  "created": 1788188983,
  "data": [
    {
      "url": "https://example.com/generated.png"
    }
  ],
  "metadata": {
    "output": {
      "choices": [
        {
          "finish_reason": "stop",
          "message": {
            "role": "assistant",
            "content": [
              {
                "type": "image",
                "image": "https://example.com/generated.png"
              }
            ]
          }
        }
      ]
    },
    "request_id": "example-request-id",
    "usage": {
      "input_image_count": 0,
      "input_image_type": "qima_input_1k",
      "output_image_count": 1,
      "output_image_type": "qima_output_1k",
      "output_width": 1080,
      "output_height": 1080
    }
  }
}

响应字段 ​

名称类型说明
integerAIX 处理请求的 Unix 时间戳
array<object>OpenAI 风格图片结果数组
string上游返回的图片 URL
string上游返回文本内容时出现
object上游原始响应
object上游原始输出结构，其中 为实际返回的图片地址。 为空时，结合本字段与 排查上游是否返回了图片
string上游请求 ID
object输入、输出图片数量和分辨率信息
object请求失败时返回的错误结构（如 HTTP 400），含 / （当前固定 ）/ /

相关接口 ​