Image API

统一提交文生图、图生图、扩图、换背景、虚拟模特、海报和擦除补全等能力;模型记录决定真实上游地址、操作类型和计费规则。

接口说明

Ling.AI 将同一个上游图像模型按“能力入口”拆成多条模型记录。也就是说,用户请求中的 model 不再只是“模型系列名”,而是“模型 + 操作”的组合,例如 qwen-image-2.0-pro_t2iqwen-image-2.0-pro_i2i。系统会根据该记录读取真实的 model_codebase_url、价格规则和任务模式,再转发到上游。

请求方式 POST
请求地址 /v1/images/generations / /v1/images/edits
认证方式 Authorization / x-api-key / x-goog-api-key

接入边界

图像接口共享用户余额、套餐、免费体验、异步任务与 usage_logs 记录链路。同步模型通常直接返回上游结果;异步模型返回任务受理信息后,需要通过 GET /v1/tasks/{task_id} 查询最终状态。

模型拆分

对外 model_id 上游 model_code operation 调用接口
qwen-image-2.0-pro_t2i qwen-image-2.0-pro t2i POST /v1/images/generations
wanx-poster-generation-v1_poster wanx-poster-generation-v1 poster POST /v1/images/generations
qwen-image-2.0-pro_i2i qwen-image-2.0-pro i2i POST /v1/images/edits
image-out-painting_outpaint image-out-painting outpaint POST /v1/images/edits
wanx-sketch-to-image-lite_sketch wanx-sketch-to-image-lite sketch POST /v1/images/edits
wanx-background-generation-v2_background wanx-background-generation-v2 background POST /v1/images/edits
wanx-style-repaint-v1_style_repaint wanx-style-repaint-v1 style_repaint POST /v1/images/edits
wanx-virtualmodel_virtualmodel wanx-virtualmodel virtualmodel POST /v1/images/edits
virtualmodel-v2_virtualmodel virtualmodel-v2 virtualmodel POST /v1/images/edits
shoemodel-v1_shoemodel shoemodel-v1 shoemodel POST /v1/images/edits
image-instance-segmentation_segmentation image-instance-segmentation segmentation POST /v1/images/edits
image-erase-completion_erase image-erase-completion erase POST /v1/images/edits
wanx-x-painting_xpainting wanx-x-painting xpainting POST /v1/images/edits

路由规则

/v1/images/generations 只接受 t2iposter 类模型;/v1/images/edits 只接受 i2ieditinpaintoutpaintbackgroundsketchstyle_repaintvirtualmodelshoemodelsegmentationerasexpainting 类模型。如果模型操作与接口不匹配,网关会直接返回 invalid_model_operation

同步与异步

图像接口是否为同步返回还是异步任务,取决于所选模型记录对应的上游真实地址:

  • qwen-image-pluswan2.6-t2i 这类异步模型,网关会附加 X-DashScope-Async: enable,若上游接受任务,会返回 202task_id
  • wanx-poster-generation-v1_poster 走百炼 text2image/image-synthesis 异步接口,仅适用于“中国内地(北京)”地域;该模型当前属于免费体验能力。
  • qwen-image-2.0-pro_t2iqwen-image-2.0-pro_i2i 这类同步模型,会直接返回上游同步结果。
  • image-out-painting_outpaint 走百炼 image2image/out-painting 异步接口,仅适用于“中国内地(北京)”地域,适合按比例扩图、按像素扩图或先旋转再扩图。
  • wanx-background-generation-v2_background 走百炼 background-generation/generation 异步接口,仅适用于“中国内地(北京)”地域,适合电商商品图和海报换背景。
  • wanx-sketch-to-image-lite_sketch 走百炼 image2image/image-synthesis 异步接口,当前仅适用于“中国内地(北京)”地域。
  • wanx-style-repaint-v1_style_repaint 走百炼 image-generation/generation 异步接口,仅适用于“中国内地(北京)”地域,提交后需通过 GET /v1/tasks/{task_id} 轮询结果。
  • wanx-virtualmodel_virtualmodelvirtualmodel-v2_virtualmodel 走百炼 virtualmodel/generation 异步接口,仅适用于“中国内地(北京)”地域;两者当前都属于免费体验能力。
  • shoemodel-v1_shoemodel 也走百炼 virtualmodel/generation 异步接口,仅适用于“中国内地(北京)”地域;该模型当前同样属于免费体验能力。
  • image-instance-segmentation_segmentationimage-erase-completion_erasewanx-x-painting_xpainting 都走百炼 image2image/image-synthesis 异步接口,仅适用于“中国内地(北京)”地域;其中前两者当前属于免费体验能力,擦除补全还会附加 X-DashScope-DataInspection: enable

异步任务

对于返回异步任务的模型,可通过 GET /v1/tasks/{task_id} 查询状态。典型场景是百炼异步图像生成接口。

curl
# 1. 提交图片生成任务
curl -X POST https://api.vip.lingapi.ai/v1/images/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-plus",
    "prompt": "一张古典中式厅堂中的对联海报",
    "negative_prompt": "模糊,低清晰度",
    "n": 1,
    "size": "1664*928",
    "prompt_extend": true,
    "watermark": false
  }'

# 2. 查询任务状态
curl https://api.vip.lingapi.ai/v1/tasks/task_xxx \
  -H "Authorization: Bearer sk-xxxxxxxx"

文生图请求

对于常规文生图入口,通常传入 prompt 即可;对于 wanx-poster-generation-v1_poster 这类创意海报入口,则使用标题、副标题、正文和风格控制字段来生成带自动排版的海报。

参数名 类型 必填 说明
model string 必须是文生图入口,例如 qwen-image-2.0-pro_t2iqwen-image-pluswan2.6-t2i
prompt string 图像描述文本,详细描述想要生成的图像
title string poster 类模型使用。海报主标题,通常不超过 30 个字符
sub_title string poster 类模型使用。海报副标题
body_text string poster 类模型使用。海报正文文案
prompt_text_zh string poster 类模型使用。中文创意提示词
prompt_text_en string poster 类模型使用。英文创意提示词
wh_ratios string poster 类模型使用。海报方向或版式,例如 竖版横版
lora_name string poster 类模型使用。海报风格名,例如 童话油画中国刺绣
lora_weight number poster 类模型使用。风格权重
ctrl_ratio number poster 类模型使用。版式控制强度
ctrl_step number poster 类模型使用。版式控制步进
generate_mode string poster 类模型使用。常见取值为 generate
generate_num integer poster 类模型使用。海报生成数量
n integer 生成图像数量,默认 1
size string 图像尺寸。qwen-image-plus 仅支持固定尺寸,wan2.6-t2i 等万相 V2 模型支持一定范围内的任意宽高组合
negative_prompt string 反向提示词,用于描述不希望出现在画面中的元素
prompt_extend boolean 是否让上游自动扩写较短提示词。百炼默认通常为 true,会额外增加少量耗时
watermark boolean 是否保留百炼默认水印。若上游模型支持,可显式设为 false

创意海报

wanx-poster-generation-v1_poster 适合生成带自动背景与文字排版的海报。常见输入包括 titlesub_titlebody_textprompt_text_zh/prompt_text_enwh_ratioslora_namelora_weightctrl_ratioctrl_stepgenerate_modegenerate_num。该模型目前仅供免费体验,免费额度耗尽后不可付费调用。

图像编辑请求

对于 qwen-image-2.0-pro_i2i 这类图像编辑入口,推荐使用多图输入结构。单次请求支持输入 1-3 张图像,图片顺序具有语义,例如提示词中的“图1”“图2”“图3”会按数组顺序对应输入图。对于 image-out-painting_outpaint,使用单张图配合比例、宽高比或像素扩展参数做画面扩展。对于 wanx-background-generation-v2_background,使用主体图 base_image_url 配合文本、引导图或 reference_edge 生成背景。对于 wanx-style-repaint-v1_style_repaint,则使用单张人物图配合 style_indexstyle_ref_url 进行风格重绘。对于 virtualmodel-v2_virtualmodelwanx-virtualmodel_virtualmodel,则使用真人或人台实拍图、保留区域掩码和人物描述生成新的模特展示图。对于 shoemodel-v1_shoemodel,则使用模特模板图和最多 3 张鞋靴多视角图做鞋靴试穿与布局重绘。

参数名 类型 必填 说明
model string 必须是图像编辑入口,例如 qwen-image-2.0-pro_i2iimage-out-painting_outpaintwanx-background-generation-v2_backgroundwanx-style-repaint-v1_style_repaintvirtualmodel-v2_virtualmodelshoemodel-v1_shoemodel
image string / object 待编辑图片,支持 URL 或上游允许的本地文件编码形式
image_url string / object outpaintstyle_repaint 等单图模型常用。对 image-out-painting_outpaint 来说,表示待扩图的原始图片
base_image_url string / object backgroundvirtualmodel 类模型使用。背景生成时表示主体商品图;虚拟模特时表示真人或人台实拍图。网关也兼容使用 imageimage_url 作为别名
mask_image_url string / object virtualmodel 类模型使用。用于指定期望保留的区域掩码
template_image_url string / object shoemodel 类模型使用。模特模板图,要求能清晰看到双脚与鞋靴区域
shoe_image_url array shoemodel 类模型使用。鞋靴多视角图列表,通常建议不超过 3 张
mask_url string / object erase 类模型使用。待擦除区域掩码图,非黑色区域表示需要移除的内容
foreground_url string / object erase 类模型使用。待保留区域掩码图,非黑色区域表示必须保留的前景内容
images array 多参考图输入。建议 1-3 张图像,并按顺序对应提示词中的 图1图2图3
prompt string 编辑指令,例如风格转换、主体修改或局部重绘描述。对 virtualmodel 来说,通常用于描述全身形象、动作和场景
face_prompt string virtualmodel 类模型使用。用于补充人像面部描述,例如 good face, beautiful face, best quality.
background_image_url string / object virtualmodel 类模型使用。可选背景参考图,适用于 virtualmodel-v2
predefined_face_id string virtualmodel 类模型使用。常见于 wanx-virtualmodel,用于指定预置面部风格或身份标识
dilate_flag boolean segmentationerase 类模型使用。是否对掩码区域做膨胀,避免边缘遗漏
fast_mode boolean erase 类模型使用。设为 true 时优先快速擦除,可能忽略部分细节
size string 输出尺寸;是否生效由具体上游模型决定。对 xpainting 常用于指定局部重绘输出分辨率
n integer 输出图片数量。像 qwen-image-2.0-pro_i2i 这类模型通常支持 1-6 张图片输出
sketch_weight integer sketch 类模型使用,控制草图线条约束强度
style string sketch 类模型使用,例如 <watercolor>
ref_prompt string background 类模型使用。文本引导背景描述;也兼容把顶层 prompt 映射为该字段
ref_image_url string / object background 类模型使用。图像引导背景参考图
reference_edge object background 类模型使用。支持 foreground_edgebackground_edgeforeground_edge_promptbackground_edge_prompt 组合控制前景与背景层
angle integer outpaint 类模型使用。可在扩图前先旋转图片,例如 90 表示逆时针旋转 90 度
x_scale number outpaint 类模型使用。横向扩展比例
y_scale number outpaint 类模型使用。纵向扩展比例
output_ratio string outpaint 类模型使用。目标宽高比,例如 4:31:1
left_offset integer outpaint 类模型使用。向左扩展的像素数
right_offset integer outpaint 类模型使用。向右扩展的像素数
top_offset integer outpaint 类模型使用。向上扩展的像素数
bottom_offset integer outpaint 类模型使用。向下扩展的像素数
best_quality boolean outpaint 类模型使用。用于控制优先质量还是速度,具体效果以上游模型为准
limit_image_size boolean outpaint 类模型使用。是否限制最终输出尺寸,具体以上游规则为准
short_side_size string virtualmodel 类模型使用。控制生成图短边大小,例如 51210242048
aspect_ratio string virtualmodel 类模型使用。可选保持原比例,或如 4:31:19:16 等目标宽高比
style_index integer style_repaint 类模型使用。预置风格时传对应风格编号;自定义风格时必须传 -1
style_ref_url string / object style_repaint 类模型使用。用于传入自定义风格参考图 URL 或 Base64 图像数据
model_version string background 类模型使用。可选 v2v3,推荐 v3
noise_level integer background 类模型使用。范围通常为 0-999,值越小越贴近 ref_image_url
ref_prompt_weight number background 类模型使用。范围通常为 0-1,用于平衡文本引导与图像引导的影响

图像画面扩展

image-out-painting_outpaint 适合为海报、封面或商品图调整布局。常见用法包括:x_scale/y_scale 等比例扩图、output_ratio 指定目标宽高比、left_offsetbottom_offset 按方向扩展像素,以及先用 angle 旋转再扩图。该入口异步返回 task_id,结果图 URL 通常只有 24 小时 有效期。

图像背景生成

wanx-background-generation-v2_background 适合商品换背景、海报合成等场景。主体图建议使用带透明背景的RGBA商品图,输出图分辨率与主体图保持一致。复杂场景可叠加 ref_promptref_image_urlreference_edge;若使用边缘引导元素,foreground_edgebackground_edge 的列表顺序对应图层从底至上。

涂鸦作画

wanx-sketch-to-image-lite_sketch 属于涂鸦作画入口,适合根据草图加文字描述生成图像。该模型当前仅适用于“中国内地(北京)”地域,建议通过 imagesketch_image_url 传入草图,常用参数为 sizensketch_weightstyle

人像风格重绘

预置风格:传入人物图和 style_index,不要传 style_ref_url自定义风格:传入人物图与 style_ref_url,并将 style_index 设为 -1。该入口异步返回 task_id,任务查询有效期与输出图片 URL 有效期通常均为 24 小时

虚拟模特

virtualmodel-v2_virtualmodel 推荐用于真人或人台实拍图换模特与换背景。常见输入包括 base_image_urlmask_image_urlpromptface_prompt 与可选的 background_image_urlwanx-virtualmodel_virtualmodel 也支持通过 predefined_face_id 指定预置面部风格。两者目前都仅供免费体验,免费额度耗尽后不可付费调用。

鞋靴模特

shoemodel-v1_shoemodel 适合对模特模板图中的鞋靴区域进行 AI 试穿与布局重绘。常见输入为 template_image_urlshoe_image_url,其中鞋靴多视角图建议不超过 3 张。该模型目前也仅供免费体验,免费额度用完后不可付费调用。

人物实例分割

image-instance-segmentation_segmentation 适合从多人照片或复杂背景里提取人物像素级掩码。常见输入为 image_url,可选 dilate_flag 用于膨胀掩码边缘;该模型目前仅供免费体验

擦除补全

image-erase-completion_erase 适合删除人物、路人、文字、水印或物体,并自动补全背景。常见输入为 image_urlmask_url 与可选 foreground_url,若追求速度可设 fast_mode=true;该模型目前仅供免费体验

局部重绘

wanx-x-painting_xpainting 适合根据 promptbase_image_urlmask_image_url 在指定区域内重绘新内容,区域外保持不变;该模型目前仅供免费体验

请求示例

如果您已经在项目里使用 OpenAI Python SDK,可继续复用统一的 OpenAI 客户端。对于 t2iposter 这类文生图入口,可直接调用 client.images.generate();对于 /v1/images/edits 下使用 URL 和扩展 JSON 字段的编辑能力,建议直接使用通用 client.post() 提交请求体。

OpenAI Python SDK:文生图

Python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.vip.lingapi.ai/v1",
    api_key="sk-xxxxxxxx"
)

result = client.images.generate(
    model="qwen-image-2.0-pro_t2i",
    prompt="一张写实摄影风格的人像,柔和自然光,浅景深",
    extra_body={
        "size": "1328*1328",
        "negative_prompt": "模糊,畸形手部,低清晰度",
        "prompt_extend": True,
        "watermark": False
    }
)

print(result.data[0].url)

OpenAI Python SDK:图像编辑

Python
import httpx
from openai import OpenAI

client = OpenAI(
    base_url="https://api.vip.lingapi.ai/v1",
    api_key="sk-xxxxxxxx"
)

response = client.post("/images/edits",
    cast_to=httpx.Response,
    body={
        "model": "wanx-x-painting_xpainting",
        "prompt": "a dog wearing red glasses",
        "base_image_url": "https://example.com/base.jpg",
        "mask_image_url": "https://example.com/mask.png",
        "size": "1024*1024",
        "n": 1
    }
)

print(response.json())

SDK 提示

client.images.generate() 会自动请求 /v1/images/generations。当前平台大多数图像编辑能力直接接收 JSON 和公网 URL,而不是 OpenAI 官方 multipart/form-data 风格的文件上传,因此更推荐使用 client.post("/images/edits", ...) 直发 JSON 请求体。

curl

curl
curl https://api.vip.lingapi.ai/v1/images/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.6-t2i",
    "prompt": "一张写实摄影风格的人像,柔和自然光,浅景深",
    "negative_prompt": "模糊,畸形手部,低清晰度",
    "n": 1,
    "size": "1440*810",
    "prompt_extend": false,
    "watermark": false
  }'
curl
curl -X POST https://api.vip.lingapi.ai/v1/images/edits \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image-instance-segmentation_segmentation",
    "image_url": "https://example.com/people.png",
    "dilate_flag": true
  }'
curl
curl -X POST https://api.vip.lingapi.ai/v1/images/edits \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image-erase-completion_erase",
    "image_url": "https://example.com/original.png",
    "mask_url": "https://example.com/mask.png",
    "foreground_url": "https://example.com/foreground.png",
    "dilate_flag": true,
    "fast_mode": false
  }'
curl
curl -X POST https://api.vip.lingapi.ai/v1/images/edits \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wanx-x-painting_xpainting",
    "prompt": "a dog wearing red glasses",
    "base_image_url": "https://example.com/base.jpg",
    "mask_image_url": "https://example.com/mask.png",
    "size": "1024*1024",
    "n": 1
  }'
curl
curl -X POST https://api.vip.lingapi.ai/v1/images/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wanx-poster-generation-v1_poster",
    "title": "春节快乐",
    "sub_title": "家庭团聚,共享天伦之乐",
    "body_text": "春节是中国最重要的传统节日之一,它象征着新的开始和希望",
    "prompt_text_zh": "灯笼,小猫,梅花",
    "wh_ratios": "竖版",
    "lora_name": "童话油画",
    "lora_weight": 0.8,
    "ctrl_ratio": 0.7,
    "ctrl_step": 0.7,
    "generate_mode": "generate",
    "generate_num": 1
  }'
curl
curl -X POST https://api.vip.lingapi.ai/v1/images/edits \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "shoemodel-v1_shoemodel",
    "template_image_url": "https://example.com/template.webp",
    "shoe_image_url": [
      "https://example.com/shoe-1.webp",
      "https://example.com/shoe-2.webp"
    ],
    "n": 1
  }'
curl
curl -X POST https://api.vip.lingapi.ai/v1/images/edits \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "virtualmodel-v2_virtualmodel",
    "base_image_url": "https://example.com/base.jpeg",
    "mask_image_url": "https://example.com/mask.png",
    "prompt": "A woman stands on a rural road",
    "face_prompt": "good face, beautiful face, best quality.",
    "background_image_url": "https://example.com/background.png",
    "short_side_size": "1024",
    "n": 1
  }'
curl
curl -X POST https://api.vip.lingapi.ai/v1/images/edits \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wanx-virtualmodel_virtualmodel",
    "base_image_url": "https://example.com/base.jpeg",
    "mask_image_url": "https://example.com/mask.png",
    "prompt": "一名年轻女子,身穿白色短裤",
    "face_prompt": "年轻女子,面容姣好,最高品质",
    "predefined_face_id": "boy3",
    "short_side_size": "512",
    "aspect_ratio": "4:3",
    "n": 2
  }'
curl
curl -X POST https://api.vip.lingapi.ai/v1/images/edits \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image-out-painting_outpaint",
    "image_url": "https://example.com/source.png",
    "angle": 90,
    "x_scale": 1.5,
    "y_scale": 1.5
  }'
curl
curl -X POST https://api.vip.lingapi.ai/v1/images/edits \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image-out-painting_outpaint",
    "image_url": "https://example.com/source.png",
    "output_ratio": "4:3",
    "best_quality": false,
    "limit_image_size": true,
    "left_offset": 546,
    "right_offset": 960,
    "top_offset": 158,
    "bottom_offset": 939
  }'
curl
curl -X POST https://api.vip.lingapi.ai/v1/images/edits \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wanx-background-generation-v2_background",
    "base_image_url": "https://example.com/product.png",
    "ref_prompt": "山脉和晚霞",
    "model_version": "v3",
    "n": 1
  }'
curl
curl -X POST https://api.vip.lingapi.ai/v1/images/edits \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wanx-background-generation-v2_background",
    "base_image_url": "https://example.com/product.png",
    "ref_image_url": "https://example.com/background-ref.jpg",
    "ref_prompt": "山脉和晚霞",
    "reference_edge": {
      "foreground_edge": ["https://example.com/foreground-1.png"],
      "background_edge": ["https://example.com/background-1.png"],
      "foreground_edge_prompt": ["粉色桃花"],
      "background_edge_prompt": ["树叶"]
    },
    "model_version": "v3",
    "ref_prompt_weight": 0.5,
    "noise_level": 300
  }'
curl
curl -X POST https://api.vip.lingapi.ai/v1/images/edits \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wanx-sketch-to-image-lite_sketch",
    "image": "https://example.com/sketch.png",
    "prompt": "一棵参天大树",
    "size": "768*768",
    "n": 2,
    "sketch_weight": 3,
    "style": ""
  }'
curl
curl -X POST https://api.vip.lingapi.ai/v1/images/edits \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-2.0-pro_i2i",
    "images": [
      "https://example.com/input1.png",
      "https://example.com/input2.png",
      "https://example.com/input3.png"
    ],
    "prompt": "图1中的女生穿着图2中的黑色裙子按图3的姿势坐下",
    "size": "1024*1536",
    "n": 2,
    "negative_prompt": " ",
    "prompt_extend": true,
    "watermark": false
  }'
curl
curl -X POST https://api.vip.lingapi.ai/v1/images/edits \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wanx-style-repaint-v1_style_repaint",
    "image_url": "https://example.com/portrait.png",
    "style_index": 3
  }'
curl
curl -X POST https://api.vip.lingapi.ai/v1/images/edits \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wanx-style-repaint-v1_style_repaint",
    "image_url": "https://example.com/portrait.png",
    "style_ref_url": "https://example.com/style.png",
    "style_index": -1
  }'

返回示例

JSON
{
  "task_id": "task_xxx",
  "request_id": "img_req_xxx",
  "status": "queued",
  "message": "Task submitted successfully. Use GET /v1/tasks/{task_id} to check status.",
  "created_at": "2026-03-15 10:00:00"
}
JSON
{
  "output": {
    "choices": [
      {
        "message": {
          "content": [
            {
              "image_url": "https://dashscope-result-example/generated.png"
            }
          ]
        }
      }
    ]
  }
}

返回体说明

异步模型通常返回任务受理结果;同步模型通常直接返回上游原始结果。对于图像编辑类同步模型,通常会在 output.choices[0].message.content 中返回多张图片 URL。当前网关不会强行把所有同步图像结果归一成同一 JSON 结构,因此接入前请按模型能力确认返回格式。

结果持久化

百炼返回的图片 URL 有效期通常只有 24 小时。生产环境中应在任务成功后立即下载图片,并转存到您自己的持久化存储,例如 OSS、本地对象存储或 CDN 源站。

支持模型

模型 提供商 支持尺寸 价格
qwen-image-plus 百炼 Qwen-Image 5 种固定尺寸,适合文字渲染与海报 以后台 billing_rules 为准
qwen-image-2.0-pro_t2i 百炼 Qwen-Image 同步文生图入口,适合复杂文字渲染 以后台 billing_rules 为准
qwen-image-2.0-pro_i2i 百炼 Qwen-Image 同步图像编辑入口,对应 i2i 以后台 billing_rules 为准
wan2.6-t2i 百炼 Wan 写实图像、摄影风格与自定义分辨率 以后台 billing_rules 为准
wanx-sketch-to-image-lite_sketch 百炼 Wan 涂鸦作画、草图加提示词、异步任务 以后台 billing_rules 为准
image-out-painting_outpaint 百炼 Wan 图像画面扩展、旋转扩图、按比例扩图、按像素扩图、异步任务 以后台 billing_rules 为准
wanx-background-generation-v2_background 百炼 Wan 商品图换背景、文本/图像引导、边缘引导元素、异步任务 以后台 billing_rules 为准
wanx-style-repaint-v1_style_repaint 百炼 Wan 人像风格重绘、预置风格与自定义风格、异步任务 以后台 billing_rules 为准
wanx-virtualmodel_virtualmodel 百炼 Wan 虚拟模特 V1、换模特与换背景、异步任务、免费体验 免费体验,不支持付费
virtualmodel-v2_virtualmodel 百炼 Wan 虚拟模特 V2、支持背景参考图与多种比例、异步任务、免费体验 免费体验,不支持付费
shoemodel-v1_shoemodel 百炼 Wan 鞋靴模特试穿、鞋靴布局重绘、异步任务、免费体验 免费体验,不支持付费
wanx-poster-generation-v1_poster 百炼 Wan 创意海报、自动背景与文字排版、异步任务、免费体验 免费体验,不支持付费
其他 type=image 模型 以当前启用记录为准 请通过 /v1/models 实时确认 以后台 billing_rules 为准

💡 提示

如果 /v1/models 暂无 type=image 记录,说明当前实例未启用图像模型;此时即使接口路由存在,也无法完成生成。对文字渲染要求较高时优先选择 qwen-image-plusqwen-image-2.0-pro_t2i;需要图像编辑时请选择 qwen-image-2.0-pro_i2i 这类编辑入口。

图像编辑端点

除图像生成接口 POST /v1/images/generations 外,系统还提供图像编辑接口:

请求方式 POST
请求地址 /v1/images/edits
认证方式 Authorization / x-api-key / x-goog-api-key

图像编辑接口支持对现有图片进行修改,如局部重绘、风格转换等。请求时需传入原始图片和编辑指令,具体可用模型与能力取决于后台启用的 type=imageoperation 包含编辑能力的模型。

💡 提示

图像编辑模型通常以 _i2i 后缀标识,如 qwen-image-2.0-pro_i2i。请通过 GET /v1/models 确认可用的编辑模型。