本文介绍通义万相-通用图像编辑模型的输入输出参数。
该模型通过简单的指令即可实现多样化的图像编辑,适用于扩图、去水印、风格迁移、图像修复、图像美化等场景。 当前支持以下功能:
图像风格化:全局风格化、局部风格化。
图像内容编辑:指令编辑(无需指定区域,仅通过指令增加/修改图片内容)、局部重绘(针对指定区域增加/删除/修改图片内容)、去文字水印(中英文)。
图像尺寸与分辨率优化:扩图(按比例扩图)、图像超分(高清放大)。
图像色彩处理:图像上色(黑白或灰度图像转为彩色图像)。
基于参考图像生成:线稿生图(先提取输入图像的线稿,再参考线稿生成图像)、参考卡通形象生图。
相关指南:图像编辑-通义万相
模型概览
模型名称 | 计费单价 | 限流(主账号与RAM子账号共用) | 免费额度 | |
任务下发接口RPS限制 | 同时处理中任务数量 | |||
wanx2.1-imageedit | 0.14元/张 | 2 | 2 | 免费额度:500张 有效期:阿里云百炼开通后180天内 |
更多说明请参见模型计费与限流。
模型效果
模型功能 | 输入图像 | 输入提示词 | 输出图像 |
全局风格化 | 转换成法国绘本风格 | ||
局部风格化 | 把房子变成木板风格。 | ||
指令编辑 | 把女孩的头发修改为红色。 | ||
局部重绘 | 输入图像 输入涂抹区域图像(白色为涂抹区域) | 一只陶瓷兔子抱着一朵陶瓷花。 | 输出图像 |
去文字水印 | 去除图像中的文字。 | ||
扩图 | 一位绿色仙子。 | ||
图像超分 | 模糊图像 | 图像超分。 | 清晰图像 |
图像上色 | 蓝色背景,黄色的叶子。 | ||
线稿生图 | 输入图像 | 北欧极简风格的客厅。 | 提取原图的线稿并生成图像 |
参考卡通形象生图 | 输入参考图(卡通形象) | 卡通形象小心翼翼地探出头,窥视着房间内一颗璀璨的蓝色宝石。 | 输出图像 |
前提条件
通义万相-通用图像编辑API支持通过HTTP和DashScope SDK进行调用。
在调用前,您需要开通模型服务并获取API Key,再配置API Key到环境变量。
如需通过SDK进行调用,请安装DashScope SDK。目前,该SDK已支持Python和Java。
HTTP调用
图像模型处理时间较长,为了避免请求超时,HTTP调用仅支持异步获取模型结果。您需要发起两个请求:
创建任务获取任务ID:首先发起创建任务请求,该请求会返回任务ID(task_id)。
根据任务ID查询结果:使用上一步获得的任务ID,查询任务状态及结果。任务成功执行时将返回图像URL,有效期24小时。
创建任务后,该任务将被加入到排队队列,等待调度执行。后续需要调用“根据任务ID查询结果接口”获取任务状态及结果。
通用图像编辑模型大约需要5-15秒。实际耗时取决于排队任务数量和网络状况,请您在获取结果时耐心等待。
步骤1:创建任务获取任务ID
POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis
请求参数 | 全局风格化
传入本地文件(base64)下面以全局风格化为例,展示Base64传参示例。 由于 Base64 编码后的字符串较长,请下载image_base64,并将文本内容全部复制到 数据格式详见传值方式。
局部风格化
指令编辑功能描述:无需指定区域,仅通过指令进行增加/修改图片内容的操作。
局部重绘功能描述:针对指定区域增加/删除/修改图片内容。
去文字水印功能描述:支持去除中英文的文字水印。
扩图功能描述:支持在上、下、左、右四个方向按比例扩图。
图像超分功能描述:支持将模糊图像进行高清放大。
图像上色功能描述:黑白或灰度图像转为彩色图像。
线稿生图功能描述:先提取输入图像的线稿,再参考线稿生成图像。
参考卡通形象生图功能描述:支持参考卡通形象生成图像。
|
请求头(Headers) | |
Content-Type 请求内容类型。此参数必须设置为 | |
Authorization 请求身份认证。接口使用阿里云百炼API-Key进行身份认证。示例值:Bearer sk-xxxx。 | |
X-DashScope-Async 异步处理配置参数。HTTP请求只支持异步,必须设置为 | |
请求体(Request Body) | |
model 模型名称。示例值:wanx2.1-imageedit。 | |
input 输入的基本信息,如提示词等。 | |
parameters 图像处理参数。 |
响应参数 | 成功响应
异常响应模型调用失败,请参见错误信息进行解决。
|
output 任务输出信息。 | |
request_id 请求唯一标识。可用于请求明细溯源和问题排查。 | |
code 请求失败的错误码。请求成功时不会返回此参数,详情请参见错误信息。 | |
message 请求失败的详细信息。请求成功时不会返回此参数,详情请参见错误信息。 |
步骤2:根据任务ID查询结果
GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}
请求参数 | 查询任务结果您需要将
|
请求头(Headers) | |
Authorization 请求身份认证。接口使用阿里云百炼API-Key进行身份认证。示例值:Bearer sk-xxxx。 | |
URL路径参数(Path parameters) | |
task_id 任务ID。 |
响应参数 | 任务执行成功任务数据(如任务状态、图像URL等)仅保留24小时,超时后会被自动清除。请您务必及时保存生成的图像。
任务执行失败如果因为某种原因导致任务执行失败,任务状态将被设置为FAILED,并通过code和message字段明确指示错误原因。请参见错误信息进行解决。
任务部分失败模型可以在一次任务中生成多张图片。只要其中一张图片生成成功,任务状态将标记为
|
output 任务输出信息。 | |
usage 输出信息统计。只对成功的结果计数。 | |
request_id 请求唯一标识。可用于请求明细溯源和问题排查。 |
DashScope SDK调用
请先确认已安装最新版DashScope SDK,否则可能导致运行报错。
DashScope SDK目前已支持Python和Java。
SDK与HTTP接口的参数名基本一致,参数结构根据不同语言的SDK封装而定。参数说明可参考HTTP调用。
由于视频模型处理时间较长,底层服务采用异步方式提供。SDK在上层进行了封装,支持同步、异步两种调用方式。
通用图像编辑模型大约需要5-15秒。实际耗时取决于排队任务数量和网络状况,请您在获取结果时耐心等待。
Python SDK调用
使用Python SDK处理图像文件时,支持以下三种方式输入图像。请根据您的场景选择其中一种即可。
公网 URL:公网可访问的图像 URL(HTTP/HTTPS)。您可在此获取临时公网URL。
Base64编码:传入Base64编码文件后的字符串,格式为
data:{MIME_type};base64,{base64_data}
。本地文件路径:支持传入文件的绝对路径和相对路径。请参考下表,传入正确的文件路径。
系统 | 传入的文件路径 | 示例(绝对路径) | 示例(相对路径) |
Linux或macOS系统 | file://{文件的绝对路径或相对路径} | file:///home/images/test.png | file://./images/test.png |
Windows系统 | file://D:/images/test.png | file://./images/test.png |
示例代码
在调用代码前,请确保已安装 DashScope Python SDK,同时推荐您升级至最新版本:pip install -U dashscope
,详见安装SDK。
同步调用
本示例展示同步调用方式,并支持三种图像输入方式:公网URL、Base64编码、本地文件路径。
请求示例
import base64
import os
from http import HTTPStatus
from dashscope import ImageSynthesis
import mimetypes
"""
环境要求:
dashscope python SDK >= 1.23.8
安装/升级SDK:
pip install -U dashscope
"""
# --- 准备工作:确保 API Key 已设置 ---
api_key = os.getenv("DASHSCOPE_API_KEY")
# --- 辅助函数:用于 Base64 编码 ---
# 格式为 data:{MIME_type};base64,{base64_data}
def encode_file(file_path):
mime_type, _ = mimetypes.guess_type(file_path)
if not mime_type or not mime_type.startswith("image/"):
raise ValueError("不支持或无法识别的图像格式")
with open(file_path, "rb") as image_file:
encoded_string = base64.b64encode(image_file.read()).decode('utf-8')
return f"data:{mime_type};base64,{encoded_string}"
"""
图像输入方式说明:
以下提供了三种图片输入方式,三选一即可
1. 使用公网URL - 适合已有公开可访问的图片
2. 使用本地文件 - 适合本地开发测试
3. 使用Base64编码 - 适合私有图片或需要加密传输的场景
"""
# 【方式一】使用公网图片 URL
mask_image_url = "http://wanx.alicdn.com/material/20250318/description_edit_with_mask_3_mask.png"
base_image_url = "http://wanx.alicdn.com/material/20250318/description_edit_with_mask_3.jpeg"
# 【方式二】使用本地文件(支持绝对路径和相对路径)
# 格式要求:file:// + 文件路径
# 示例(绝对路径):
# mask_image_url = "file://" + "/path/to/your/mask_image.png" # Linux/macOS
# base_image_url = "file://" + "C:/path/to/your/base_image.jpeg" # Windows
# 示例(相对路径):
# mask_image_url = "file://" + "./mask_image.png" # 以实际路径为准
# base_image_url = "file://" + "./base_image.jpeg" # 以实际路径为准
# 【方式三】使用Base64编码的图片
# mask_image_url = encode_file("./mask_image.png") # 以实际路径为准
# base_image_url = encode_file("./base_image.jpeg") # 以实际路径为准
def sample_sync_call_imageedit():
print('please wait...')
rsp = ImageSynthesis.call(api_key=api_key,
model="wanx2.1-imageedit",
function="description_edit_with_mask",
prompt="陶瓷兔子拿着陶瓷小花",
mask_image_url=mask_image_url,
base_image_url=base_image_url,
n=1)
assert rsp.status_code == HTTPStatus.OK
print('response: %s' % rsp)
if rsp.status_code == HTTPStatus.OK:
for result in rsp.output.results:
print("---------------------------")
print(result.url)
else:
print('sync_call Failed, status_code: %s, code: %s, message: %s' %
(rsp.status_code, rsp.code, rsp.message))
if __name__ == '__main__':
sample_sync_call_imageedit()
响应示例
url 有效期24小时,请及时下载图像。
{
"status_code": 200,
"request_id": "dc41682c-4e4a-9010-bc6f-xxxxxx",
"code": null,
"message": "",
"output": {
"task_id": "6e319d88-a07a-420c-9493-xxxxxx",
"task_status": "SUCCEEDED",
"results": [
{
"url": "https://dashscope-result-wlcb-acdr-1.oss-cn-wulanchabu-acdr-1.aliyuncs.com/xxx.png?xxxxxx"
}
],
"submit_time": "2025-05-26 14:58:27.320",
"scheduled_time": "2025-05-26 14:58:27.339",
"end_time": "2025-05-26 14:58:39.170",
"task_metrics": {
"TOTAL": 1,
"SUCCEEDED": 1,
"FAILED": 0
}
},
"usage": {
"image_count": 1
}
}
异步调用
本示例仅展示异步调用方式。
请求示例
import os
from http import HTTPStatus
from dashscope import ImageSynthesis
"""
环境要求:
dashscope python SDK >= 1.23.4
安装/升级SDK:
pip install -U dashscope
"""
# 从环境变量中获取 DashScope API Key(即阿里云百炼平台 API key)
api_key = os.getenv("DASHSCOPE_API_KEY")
# 使用公网图片 URL
mask_image_url = "http://wanx.alicdn.com/material/20250318/description_edit_with_mask_3_mask.png"
base_image_url = "http://wanx.alicdn.com/material/20250318/description_edit_with_mask_3.jpeg"
def sample_async_call_imageedit():
# 异步调用,返回一个task_id
rsp = ImageSynthesis.async_call(api_key=api_key,
model="wanx2.1-imageedit",
function="description_edit_with_mask",
prompt="陶瓷兔子拿着陶瓷小花",
mask_image_url=mask_image_url,
base_image_url=base_image_url,
n=1)
print(rsp)
if rsp.status_code == HTTPStatus.OK:
print("task_id: %s" % rsp.output.task_id)
else:
print('Failed, status_code: %s, code: %s, message: %s' %
(rsp.status_code, rsp.code, rsp.message))
# 获取异步任务信息
status = ImageSynthesis.fetch(rsp)
if status.status_code == HTTPStatus.OK:
print(status.output.task_status) # check the task status
else:
print('Failed, status_code: %s, code: %s, message: %s' %
(status.status_code, status.code, status.message))
# 等待异步任务结束
rsp = ImageSynthesis.wait(rsp)
print(rsp)
if rsp.status_code == HTTPStatus.OK:
print(rsp.output)
for result in rsp.output.results:
print("---------------------------")
print(result.url)
else:
print('Failed, status_code: %s, code: %s, message: %s' %
(rsp.status_code, rsp.code, rsp.message))
if __name__ == '__main__':
sample_async_call_imageedit()
响应示例
1、创建任务的响应示例
{
"status_code": 200,
"request_id": "6dc3bf6c-be18-9268-9c27-xxxxxx",
"code": "",
"message": "",
"output": {
"task_id": "686391d9-7ecf-4290-a8e9-xxxxxx",
"task_status": "PENDING",
"video_url": ""
},
"usage": null
}
2、查询任务结果的响应示例
url 有效期24小时,请及时下载图像。
{
"status_code": 200,
"request_id": "dc41682c-4e4a-9010-bc6f-xxxxxx",
"code": null,
"message": "",
"output": {
"task_id": "6e319d88-a07a-420c-9493-xxxxxx",
"task_status": "SUCCEEDED",
"results": [
{
"url": "https://dashscope-result-wlcb-acdr-1.oss-cn-wulanchabu-acdr-1.aliyuncs.com/xxx.png?Expires=17xxxxxx"
}
],
"submit_time": "2025-05-26 14:58:27.320",
"scheduled_time": "2025-05-26 14:58:27.339",
"end_time": "2025-05-26 14:58:39.170",
"task_metrics": {
"TOTAL": 1,
"SUCCEEDED": 1,
"FAILED": 0
}
},
"usage": {
"image_count": 1
}
}
Java SDK调用
使用Java SDK处理图像文件时,支持以下三种方式输入图像。请根据您的场景选择其中一种即可。
公网 URL:公网可访问的图像 URL(HTTP/HTTPS)。您可在此获取临时公网URL。
Base 64编码:传入Base64编码文件后的字符串,格式为
data:{MIME_type};base64,{base64_data}
。本地文件路径:仅支持传入文件的绝对路径。请参考下表,传入正确的文件路径。
系统 | 传入的文件路径 | 示例 |
Linux或macOS系统 | file://{文件的绝对路径} | file:///home/images/test.png |
Windows系统 | file:///{文件的绝对路径} | file:///D:/images/test.png |
示例代码
在调用代码前,请确保已安装 DashScope Java SDK。推荐您升级至最新版本,详见安装SDK。
同步调用
本示例展示同步调用方式,并支持三种图像输入方式:公网URL、Base64编码、本地文件路径。
请求示例
// Copyright (c) Alibaba, Inc. and its affiliates.
import com.alibaba.dashscope.aigc.imagesynthesis.ImageSynthesis;
import com.alibaba.dashscope.aigc.imagesynthesis.ImageSynthesisParam;
import com.alibaba.dashscope.aigc.imagesynthesis.ImageSynthesisResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.JsonUtils;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.Base64;
import java.util.HashMap;
import java.util.Map;
/**
* 环境要求
* dashscope java SDK >=2.20.9
* 更新maven依赖:
* https://mvnrepository.com/artifact/com.alibaba/dashscope-sdk-java
*/
public class ImageEditSync {
// 从环境变量中获取 DashScope API Key(即阿里云百炼平台 API 密钥)
static String apiKey = System.getenv("DASHSCOPE_API_KEY");
/**
* 图像输入方式说明:三选一即可
*
* 1. 使用公网URL - 适合已有公开可访问的图片
* 2. 使用本地文件 - 适合本地开发测试
* 3. 使用Base64编码 - 适合私有图片或需要加密传输的场景
*/
//【方式一】公网URL
static String maskImageUrl = "http://wanx.alicdn.com/material/20250318/description_edit_with_mask_3_mask.png";
static String baseImageUrl = "http://wanx.alicdn.com/material/20250318/description_edit_with_mask_3.jpeg";
//【方式二】本地文件路径(file://+绝对路径 or file:///+绝对路径)
// static String maskImageUrl = "file://" + "/your/path/to/mask_image.png"; // Linux/macOS
// static String baseImageUrl = "file:///" + "C:/your/path/to/base_image.png"; // Windows
//【方式三】Base64编码
// static String maskImageUrl = encodeFile("/your/path/to/mask_image.png");
// static String baseImageUrl = encodeFile("/your/path/to/base_image.png");
public static void syncCall() {
// 设置parameters参数
Map<String, Object> parameters = new HashMap<>();
parameters.put("prompt_extend", true);
ImageSynthesisParam param =
ImageSynthesisParam.builder()
.apiKey(apiKey)
.model("wanx2.1-imageedit")
.function(ImageSynthesis.ImageEditFunction.DESCRIPTION_EDIT_WITH_MASK)
.prompt("陶瓷兔子拿着陶瓷小花")
.maskImageUrl(maskImageUrl)
.baseImageUrl(baseImageUrl)
.n(1)
.size("1024*1024")
.parameters(parameters)
.build();
ImageSynthesis imageSynthesis = new ImageSynthesis();
ImageSynthesisResult result = null;
try {
System.out.println("---sync call, please wait a moment----");
result = imageSynthesis.call(param);
} catch (ApiException | NoApiKeyException e){
throw new RuntimeException(e.getMessage());
}
System.out.println(JsonUtils.toJson(result));
}
/**
* 将文件编码为Base64字符串
* @param filePath 文件路径
* @return Base64字符串,格式为 data:{MIME_type};base64,{base64_data}
*/
public static String encodeFile(String filePath) {
Path path = Paths.get(filePath);
if (!Files.exists(path)) {
throw new IllegalArgumentException("文件不存在: " + filePath);
}
// 检测MIME类型
String mimeType = null;
try {
mimeType = Files.probeContentType(path);
} catch (IOException e) {
throw new IllegalArgumentException("无法检测文件类型: " + filePath);
}
if (mimeType == null || !mimeType.startsWith("image/")) {
throw new IllegalArgumentException("不支持或无法识别的图像格式");
}
// 读取文件内容并编码
byte[] fileBytes = null;
try{
fileBytes = Files.readAllBytes(path);
} catch (IOException e) {
throw new IllegalArgumentException("无法读取文件内容: " + filePath);
}
String encodedString = Base64.getEncoder().encodeToString(fileBytes);
return "data:" + mimeType + ";base64," + encodedString;
}
public static void main(String[] args) {
syncCall();
}
}
响应示例
url 有效期24小时,请及时下载图像。
{
"request_id": "bf6c6361-f0fc-949c-9d60-xxxxxx",
"output": {
"task_id": "958db858-153b-4c81-b243-xxxxxx",
"task_status": "SUCCEEDED",
"results": [
{
"url": "https://dashscope-result-wlcb-acdr-1.oss-cn-wulanchabu-acdr-1.aliyuncs.com/xxx.png?xxxxxx"
}
],
"task_metrics": {
"TOTAL": 1,
"SUCCEEDED": 1,
"FAILED": 0
}
},
"usage": {
"image_count": 1
}
}
异步调用
本示例仅展示异步调用方式。
请求示例
// Copyright (c) Alibaba, Inc. and its affiliates.
import com.alibaba.dashscope.aigc.imagesynthesis.ImageSynthesis;
import com.alibaba.dashscope.aigc.imagesynthesis.ImageSynthesisListResult;
import com.alibaba.dashscope.aigc.imagesynthesis.ImageSynthesisParam;
import com.alibaba.dashscope.aigc.imagesynthesis.ImageSynthesisResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.task.AsyncTaskListParam;
import com.alibaba.dashscope.utils.JsonUtils;
import java.util.HashMap;
import java.util.Map;
/**
* 环境要求
* dashscope java SDK >= 2.20.1
* 更新maven依赖:
* https://mvnrepository.com/artifact/com.alibaba/dashscope-sdk-java
*/
public class ImageEditAsync {
// 从环境变量中获取 DashScope API Key(即阿里云百炼平台 API 密钥)
static String apiKey = System.getenv("DASHSCOPE_API_KEY");
//【方式一】公网URL
static String maskImageUrl = "http://wanx.alicdn.com/material/20250318/description_edit_with_mask_3_mask.png";
static String baseImageUrl = "http://wanx.alicdn.com/material/20250318/description_edit_with_mask_3.jpeg";
public static void asyncCall() {
// 设置parameters参数
Map<String, Object> parameters = new HashMap<>();
parameters.put("prompt_extend", true);
ImageSynthesisParam param =
ImageSynthesisParam.builder()
.apiKey(apiKey)
.model("wanx2.1-imageedit")
.function(ImageSynthesis.ImageEditFunction.DESCRIPTION_EDIT_WITH_MASK)
.prompt("陶瓷兔子拿着陶瓷小花")
.maskImageUrl(maskImageUrl)
.baseImageUrl(baseImageUrl)
.n(1)
.size("1024*1024")
.parameters(parameters)
.build();
ImageSynthesis imageSynthesis = new ImageSynthesis();
ImageSynthesisResult result = null;
try {
System.out.println("---async call, please wait a moment----");
result = imageSynthesis.asyncCall(param);
} catch (ApiException | NoApiKeyException e){
throw new RuntimeException(e.getMessage());
}
System.out.println(JsonUtils.toJson(result));
String taskId = result.getOutput().getTaskId();
System.out.println("taskId=" + taskId);
try {
result = imageSynthesis.wait(taskId, apiKey);
} catch (ApiException | NoApiKeyException e){
throw new RuntimeException(e.getMessage());
}
System.out.println(JsonUtils.toJson(result));
System.out.println(JsonUtils.toJson(result.getOutput()));
}
public static void listTask() throws ApiException, NoApiKeyException {
ImageSynthesis is = new ImageSynthesis();
AsyncTaskListParam param = AsyncTaskListParam.builder().build();
ImageSynthesisListResult result = is.list(param);
System.out.println(result);
}
public void fetchTask(String taskId) throws ApiException, NoApiKeyException {
ImageSynthesis is = new ImageSynthesis();
// 如果已设置 DASHSCOPE_API_KEY 为环境变量,apiKey 可为空。
ImageSynthesisResult result = is.fetch(taskId, null);
System.out.println(result.getOutput());
System.out.println(result.getUsage());
}
public static void main(String[] args) {
asyncCall();
}
}
响应示例
1、创建任务的响应示例
{
"request_id": "5dbf9dc5-4f4c-9605-85ea-xxxxxxxx",
"output": {
"task_id": "7277e20e-aa01-4709-xxxxxxxx",
"task_status": "PENDING"
}
}
2、查询任务结果的响应示例
video_url 有效期24小时,请及时下载视频。
{
"request_id": "3d740fc4-a968-9c36-b0e7-xxxxxxxx",
"output": {
"task_id": "34dcf4b0-ed84-441e-91cb-xxxxxxxx",
"task_status": "SUCCEEDED",
"video_url": "https://dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com/aaaa.mp4"
},
"usage": {
"video_count": 1,
"video_duration": 5,
"video_ratio": "standard"
}
}
错误码
如果模型调用失败并返回报错信息,请参见错误信息进行解决。
此API还有特定状态码,具体如下所示。
HTTP状态码 | 接口错误码(code) | 接口错误信息(message) | 含义说明 |
400 | InvalidParameter | InvalidParameter | 请求参数不合法。 |
400 | IPInfringementSuspect | Input data is suspected of being involved in IP infringement. | 输入数据(如提示词或图像)涉嫌知识产权侵权。请检查输入,确保不包含引发侵权风险的内容。 |
400 | DataInspectionFailed | Input data may contain inappropriate content. | 输入数据(如提示词或图像)可能包含敏感内容。请修改输入后重试。 |
500 | InternalError | InternalError | 服务异常。请先尝试重试,排除偶发情况。 |
输入图像说明
传值方式
输入图像支持多种字符串格式,不同调用方式的支持情况如下表所示。
调用方式 | HTTP | Python SDK | Java SDK |
支持的输入图像方式 |
|
|
|
方式一:使用公网URL
提供一个公网可访问的图像地址,支持 HTTP 或 HTTPS 协议。请在此获取临时公网URL。
示例值:
https://xxxx/img.png
。
方式二:使用Base64编码
将本地图片文件转换为 Base64 格式的字符串,并根据data:{MIME_type};base64,{base64_data}
格式拼接成完整的字符串。
转换代码请参见示例代码。
{MIME_type}:图像的媒体类型,需与文件格式对应。
{base64_data}:图像文件经过 Base64 编码后的字符串。
MIME 类型对应关系:
图像格式
MIME Type
JPEG
image/jpeg
JPG
image/jpeg
PNG
image/png
BMP
image/bmp
TIFF
image/tiff
WEBP
image/webp
示例值:
"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAABDg......"
。注意:为便于展示,上述 Base64 字符串是截断的。在实际使用中,请务必传入完整的编码字符串。
方式三:本地文件路径
HTTP调用不支持本地文件路径,仅Python SDK和Java SDK支持。
关于本地文件路径的传入规则,请参见Python SDK调用和Java SDK调用。
图像访问配置
配置域名白名单:确保业务系统可访问图像链接
模型生成的图像存储于阿里云OSS,每张图像会被分配一个OSS链接,如https://dashscope-result-xx.oss-cn-xxxx.aliyuncs.com/xxx.png
。OSS链接允许公开访问,您可以使用此链接查看或者下载图片,链接仅在 24 小时内有效。
特别注意的是,如果您的业务对安全性要求较高,无法访问阿里云OSS链接,您需要单独配置外网访问白名单。请将以下域名添加到您的白名单中,以便顺利访问图片链接。
# OSS域名列表
dashscope-result-bj.oss-cn-beijing.aliyuncs.com
dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com
dashscope-result-sh.oss-cn-shanghai.aliyuncs.com
dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com
dashscope-result-zjk.oss-cn-zhangjiakou.aliyuncs.com
dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com
dashscope-result-hy.oss-cn-heyuan.aliyuncs.com
dashscope-result-cd.oss-cn-chengdu.aliyuncs.com
dashscope-result-gz.oss-cn-guangzhou.aliyuncs.com
dashscope-result-wlcb-acdr-1.oss-cn-wulanchabu-acdr-1.aliyuncs.com
常见问题
图像模型的通用问题请参见常见问题文档,包括以下内容:模型计费与限流规则、接口高频报错解决方法等。