接口说明
Ling.AI 将同一个上游图像模型按“能力入口”拆成多条模型记录。也就是说,用户请求中的 model 不再只是“模型系列名”,而是“模型 + 操作”的组合,例如 qwen-image-2.0-pro_t2i 与 qwen-image-2.0-pro_i2i。系统会根据该记录读取真实的 model_code、base_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 只接受 t2i、poster 类模型;/v1/images/edits 只接受 i2i、edit、inpaint、outpaint、background、sketch、style_repaint、virtualmodel、shoemodel、segmentation、erase、xpainting 类模型。如果模型操作与接口不匹配,网关会直接返回 invalid_model_operation。
同步与异步
图像接口是否为同步返回还是异步任务,取决于所选模型记录对应的上游真实地址:
- 像
qwen-image-plus、wan2.6-t2i这类异步模型,网关会附加X-DashScope-Async: enable,若上游接受任务,会返回202和task_id。 wanx-poster-generation-v1_poster走百炼text2image/image-synthesis异步接口,仅适用于“中国内地(北京)”地域;该模型当前属于免费体验能力。- 像
qwen-image-2.0-pro_t2i、qwen-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_virtualmodel与virtualmodel-v2_virtualmodel走百炼virtualmodel/generation异步接口,仅适用于“中国内地(北京)”地域;两者当前都属于免费体验能力。shoemodel-v1_shoemodel也走百炼virtualmodel/generation异步接口,仅适用于“中国内地(北京)”地域;该模型当前同样属于免费体验能力。image-instance-segmentation_segmentation、image-erase-completion_erase与wanx-x-painting_xpainting都走百炼image2image/image-synthesis异步接口,仅适用于“中国内地(北京)”地域;其中前两者当前属于免费体验能力,擦除补全还会附加X-DashScope-DataInspection: enable。
异步任务
对于返回异步任务的模型,可通过 GET /v1/tasks/{task_id} 查询状态。典型场景是百炼异步图像生成接口。
# 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_t2i、qwen-image-plus、wan2.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 适合生成带自动背景与文字排版的海报。常见输入包括 title、sub_title、body_text、prompt_text_zh/prompt_text_en、wh_ratios、lora_name、lora_weight、ctrl_ratio、ctrl_step、generate_mode 和 generate_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_index 或 style_ref_url 进行风格重绘。对于 virtualmodel-v2_virtualmodel 与 wanx-virtualmodel_virtualmodel,则使用真人或人台实拍图、保留区域掩码和人物描述生成新的模特展示图。对于 shoemodel-v1_shoemodel,则使用模特模板图和最多 3 张鞋靴多视角图做鞋靴试穿与布局重绘。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
model |
string | 是 | 必须是图像编辑入口,例如 qwen-image-2.0-pro_i2i、image-out-painting_outpaint、wanx-background-generation-v2_background、wanx-style-repaint-v1_style_repaint、virtualmodel-v2_virtualmodel、shoemodel-v1_shoemodel |
image |
string / object | 是 | 待编辑图片,支持 URL 或上游允许的本地文件编码形式 |
image_url |
string / object | 否 | 仅 outpaint、style_repaint 等单图模型常用。对 image-out-painting_outpaint 来说,表示待扩图的原始图片 |
base_image_url |
string / object | 否 | 仅 background、virtualmodel 类模型使用。背景生成时表示主体商品图;虚拟模特时表示真人或人台实拍图。网关也兼容使用 image 或 image_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 | 否 | 仅 segmentation、erase 类模型使用。是否对掩码区域做膨胀,避免边缘遗漏 |
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_edge、background_edge、foreground_edge_prompt、background_edge_prompt 组合控制前景与背景层 |
angle |
integer | 否 | 仅 outpaint 类模型使用。可在扩图前先旋转图片,例如 90 表示逆时针旋转 90 度 |
x_scale |
number | 否 | 仅 outpaint 类模型使用。横向扩展比例 |
y_scale |
number | 否 | 仅 outpaint 类模型使用。纵向扩展比例 |
output_ratio |
string | 否 | 仅 outpaint 类模型使用。目标宽高比,例如 4:3 或 1: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 类模型使用。控制生成图短边大小,例如 512、1024 或 2048 |
aspect_ratio |
string | 否 | 仅 virtualmodel 类模型使用。可选保持原比例,或如 4:3、1:1、9:16 等目标宽高比 |
style_index |
integer | 否 | 仅 style_repaint 类模型使用。预置风格时传对应风格编号;自定义风格时必须传 -1 |
style_ref_url |
string / object | 否 | 仅 style_repaint 类模型使用。用于传入自定义风格参考图 URL 或 Base64 图像数据 |
model_version |
string | 否 | 仅 background 类模型使用。可选 v2 或 v3,推荐 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_offset 到 bottom_offset 按方向扩展像素,以及先用 angle 旋转再扩图。该入口异步返回 task_id,结果图 URL 通常只有 24 小时 有效期。
图像背景生成
wanx-background-generation-v2_background 适合商品换背景、海报合成等场景。主体图建议使用带透明背景的RGBA商品图,输出图分辨率与主体图保持一致。复杂场景可叠加 ref_prompt、ref_image_url 和 reference_edge;若使用边缘引导元素,foreground_edge 与 background_edge 的列表顺序对应图层从底至上。
涂鸦作画
wanx-sketch-to-image-lite_sketch 属于涂鸦作画入口,适合根据草图加文字描述生成图像。该模型当前仅适用于“中国内地(北京)”地域,建议通过 image 或 sketch_image_url 传入草图,常用参数为 size、n、sketch_weight 与 style。
人像风格重绘
预置风格:传入人物图和 style_index,不要传 style_ref_url。自定义风格:传入人物图与 style_ref_url,并将 style_index 设为 -1。该入口异步返回 task_id,任务查询有效期与输出图片 URL 有效期通常均为 24 小时。
虚拟模特
virtualmodel-v2_virtualmodel 推荐用于真人或人台实拍图换模特与换背景。常见输入包括 base_image_url、mask_image_url、prompt、face_prompt 与可选的 background_image_url。wanx-virtualmodel_virtualmodel 也支持通过 predefined_face_id 指定预置面部风格。两者目前都仅供免费体验,免费额度耗尽后不可付费调用。
鞋靴模特
shoemodel-v1_shoemodel 适合对模特模板图中的鞋靴区域进行 AI 试穿与布局重绘。常见输入为 template_image_url 和 shoe_image_url,其中鞋靴多视角图建议不超过 3 张。该模型目前也仅供免费体验,免费额度用完后不可付费调用。
人物实例分割
image-instance-segmentation_segmentation 适合从多人照片或复杂背景里提取人物像素级掩码。常见输入为 image_url,可选 dilate_flag 用于膨胀掩码边缘;该模型目前仅供免费体验。
擦除补全
image-erase-completion_erase 适合删除人物、路人、文字、水印或物体,并自动补全背景。常见输入为 image_url、mask_url 与可选 foreground_url,若追求速度可设 fast_mode=true;该模型目前仅供免费体验。
局部重绘
wanx-x-painting_xpainting 适合根据 prompt、base_image_url 与 mask_image_url 在指定区域内重绘新内容,区域外保持不变;该模型目前仅供免费体验。
请求示例
如果您已经在项目里使用 OpenAI Python SDK,可继续复用统一的 OpenAI 客户端。对于 t2i、poster 这类文生图入口,可直接调用 client.images.generate();对于 /v1/images/edits 下使用 URL 和扩展 JSON 字段的编辑能力,建议直接使用通用 client.post() 提交请求体。
OpenAI Python SDK:文生图
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:图像编辑
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 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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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
}'
返回示例
{
"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"
}
{
"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-plus 或 qwen-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=image 且 operation 包含编辑能力的模型。
💡 提示
图像编辑模型通常以 _i2i 后缀标识,如 qwen-image-2.0-pro_i2i。请通过 GET /v1/models 确认可用的编辑模型。