图片生成

qwen-image-3.0-pro（以及 bailian/ 别名）在同一端点支持文生图和最多 3 张参考图的图生图。

支持：model、prompt、size、images、prompt_extend、prompt_extend_mode、enable_thinking、negative_prompt、seed、watermark、response_format。

官方兼容接口还支持 n=1..6，但当前网关会明确拒绝 Qwen 的 n，因此本规范不暴露该字段。prompt_extend_mode=agent 仅支持文生图；enable_thinking 仅在 prompt_extend=true 时生效。

POST https://api.tikway.ai/v1/images/generations

cURL

文生图

curl --request POST \
  --url https://api.tikway.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "bailian/qwen-image-3.0-pro",
  "prompt": "一张电影感的上海雨夜街景，霓虹灯倒映在湿润路面上，写实摄影",
  "size": "1024x1024",
  "prompt_extend": true,
  "watermark": false
}
'

200

{
  "created": 1788451200,
  "background": "opaque",
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA...",
      "index": 0
    }
  ],
  "output_format": "png",
  "size": "1024x1024"
}

授权

Authorization · string · header · 必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

model · enum<string> · 必填

必填。推荐使用公开模型 ID bailian/qwen-image-3.0-pro；未使用供应商前缀的短模型名仅在账户别名已配置时可用。

可用选项: bailian/qwen-image-3.0-pro, qwen-image-3.0-pro

prompt · string · 必填

必填。图片生成或编辑指令，支持中文和英文。官方建议不超过约 4,500 tokens。

Minimum string length: 1

size · string · 默认值: 1024x1024

可选。输出尺寸，格式为 WIDTHxHEIGHT，例如 1024x1024。省略或传 auto 时，网关向上游发送 1024x1024；官方像素面积范围为 512×512 到 2048×2048，宽高比 1:8～8:1。

Pattern: ^(auto|[1-9]\d*x[1-9]\d*)$

示例:

"1024x1024"

"2048x2048"

"1536x1024"

images · object[]

可选。图生图/编辑参考图，最多 3 张。每项提供 file_id 或 image_url；省略时为文生图。

Required array length: 1 - 3 elements

Hide child attributes

images. file_id · string

已上传至 Files API 的源图文件 ID。

images. image_url · string

完整图片 URL，或 Base64 data URL。

prompt_extend · boolean · 默认值: true

可选。是否启用智能提示词改写。

prompt_extend_mode · enum<string> · 默认值: direct

可选。提示词改写模式。direct 支持文生图和图生图；agent 仅支持文生图。

可用选项: direct, agent

enable_thinking · boolean · 默认值: true

可选。是否启用思考模式。设为 true 时不能显式关闭 prompt_extend。

negative_prompt · string

可选。描述不希望出现在结果中的内容。

seed · integer

可选。随机种子。固定种子可提高结果复现性，但不保证像素级一致。

必填范围: 0 <= x <= 2147483647

watermark · boolean · 默认值: false

可选。是否在生成图片右下角添加 Qwen-Image 水印。

response_format · enum<string> · 默认值: b64_json

固定返回 Base64 图片，使响应符合本接口的 Response Schema。

可用选项: b64_json, url

响应

200 - application/json

图片生成成功。网关已下载上游临时图片并转换为不带 data URL 前缀的 Base64。

created · integer<int64> · 必填

网关完成响应转换时的 Unix 时间戳（秒）。

必填范围: x >= 0

background · string · 必填

当前 Qwen 路径固定返回 opaque。

Allowed value: "opaque"

data · object[] · 必填

生成结果列表。

Minimum array length: 1

Hide child attributes

data. b64_json · string · 必填

网关下载并转换后的 Base64 图片。

Minimum string length: 1

data. index · integer · 必填

结果索引。

必填范围: x >= 0

output_format · enum<string>

网关根据下载图片的 Content-Type 推断出的格式。上游未提供可识别类型时省略。

可用选项: png, jpeg, webp

size · string

实际或请求的输出尺寸。请求与上游响应均未提供尺寸时省略。

Pattern: ^[1-9][0-9]*x[1-9][0-9]*$