Skip to main content
图像生成

常见问题

图像API接口的通用问题汇总，包含接口调试、模型计费与限流、接口高频报错等。

本文涉及的图像模型有：文生图V1和V2、涂鸦作画、图像局部重绘、Cosplay动漫人物生成、人像风格重绘、虚拟模特、鞋靴模特、图像画面扩展、人物实例分割、图像擦除补全、创意海报生成、图像背景生成、图配文。

本地调试接口

图像API均支持HTTP调用。下面以文生图API为例展示本地调试HTTP接口的流程。
  1. 需要开通模型服务并获取API Key，再配置API Key到环境变量。
  2. 在图像API文档中找到curl命令。
curl -X POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wanx2.1-t2i-turbo",
    "input": {
        "prompt": "一间有着精致窗户的花店，漂亮的木质门，摆放着花朵"
    },
    "parameters": {
        "size": "1024*1024",
        "n": 1
    }
}'
  1. 若操作系统为macOS或Linux，可在终端执行curl命令。
  2. 若操作系统为Windows，可使用Postman、Apifox等接口平台发送HTTP请求。
注意：使用接口平台发送请求时，需要将curl命令Bearer $DASHSCOPE_API_KEY中的$DASHSCOPE_API_KEY替换为真实API_KEY，比如Bearer sk-xxxxxx。

模型计费与限流

模型计费示例
注：表格中图像模型1、图像模型2仅用作示例说明，不是真实的模型名称。

模型名称

免费额度（查看）

计费单价

限流（主账号与RAM子账号共用）

任务下发接口QPS限制

同时处理中任务数量

图像模型1

500张

限时免费

2

1

图像模型2

500张

$0.02/张

2

1

免费额度
  • 额度说明：免费额度是指模型成功生成的输出图片数量。输入图片及模型处理失败的情况不占用免费额度。
  • 领取方式：开通阿里云百炼大模型服务后自动发放，有效期90天。
  • 使用账号：阿里云主账号与其RAM子账号共享免费额度。
  • 更多详情请参见新人免费额度。
限时免费
  • 当计费为“限时免费”时，表示该模型处于公测阶段，免费额度用尽后不可使用。
计费说明
  • 当计费有明确单价时，如$0.02/张，表示该模型已商业化，免费额度用尽或过期后需付费使用。
  • 计费项：只对模型成功生成的输出图片进行收费，其余情况暂不计费。
  • 付费方式：由阿里云主账号统一付费。RAM子账号不能独立计量计费，必须由所属的主账号付费。如果您需要查询账单信息，请前往阿里云控制台账单概览。
  • 充值途径：您可以在阿里云控制台费用与成本页面进行充值。
  • 模型调用情况：您可以前往阿里云百炼平台的模型观测（新加坡或北京）查看模型调用量及调用次数。
  • 更多计费问题请参见计费项。
限流
  • 限流说明：阿里云主账号与其RAM子账号共享限流限制。

接口报错

图像无法下载或下载失败

报错场景：当使用您自己的图片链接（非文档示例图片链接）请求接口时，报错提示“下载图片失败，请检查图片url”。 
{
    "request_id": "657f0d1b-76d0-9e3e-b6d6-xxxxxx",
    "output": {
        "task_id": "5e6fa974-9a25-4271-8659-xxxxxx",
        "task_status": "FAILED",
        "code": "BadRequest.InputDownloadFailed",
        "message": "Reference image download failed, please check image url."
    }
}
可能原因：输入的图片URL链接存在错误、无法访问或下载权限受限等问题，导致模型服务无法成功下载图片。 解决方案：请确保图片URL链接完整，并能够支持公网访问。您可以将图片上传至可供公网访问的自建存储服务，或选择上传至OSS等云存储服务。请务必确保图片URL能够支持公网访问。

调用图片生成 API 返回 InvalidParameter: url error

报错场景：调用图片生成 API (/api/v1/services/aigc/text2image/image-synthesis) 时，model 参数填写了文本生成模型名（如 qwen-turbo），接口返回如下报错。 
{
    "code": "InvalidParameter",
    "message": "url error, please check url！"
}
使用 OpenAI 兼容模式并填写文本生成模型名时，接口返回空响应。 可能原因：model 参数与调用的接口不匹配。图片生成接口只接受图片生成模型名，传入文本生成模型名（如 qwen-turbo）时，服务端无法正确解析请求，从而返回 url error。报错文案中的“url”并不代表请求地址或图片链接有问题。 解决方案：将 model 参数改为图片生成模型名（如 wanx2.1-t2i-turbo），并按异步方式调用。 
curl -X POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wanx2.1-t2i-turbo",
    "input": {
        "prompt": "a cute cat"
    },
    "parameters": {
        "size": "1024*1024",
        "n": 1
    }
}'
图片生成 API 为异步调用，创建任务成功后返回 task_id，需通过 GET /api/v1/tasks/{task_id} 轮询任务结果，task_status 变为 SUCCEEDED 后即可获取生成的图片 URL。

创建任务接口的curl命令执行失败

报错场景：如果您在文档中复制创建任务接口的curl命令，执行后报错。下面以图像背景生成模型的curl命令为例。 
curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/background-generation/generation' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "wanx-background-generation-v2",
    "input": {
        "base_image_url": "https://vision-poster.oss-cn-shanghai.aliyuncs.com/lllcho.lc/data/test_data/images/main_images/new_main_img/a.png",
        "ref_image_url": "http://vision-poster.oss-cn-shanghai.aliyuncs.com/lllcho.lc/data/test_data/images/ref_images/c5e50d27be534709817b2ab080b0162f_0.jpg",
        "ref_prompt": "山脉和晚霞",
        "reference_edge": {
            "foreground_edge": [
                "https://vision-poster.oss-cn-shanghai.aliyuncs.com/lllcho.lc/data/test_data/images/huaban_soft_edge/6cdd13941cef1b11d885aea1717b983ae566b8efc9094-vcsvxa_fw658webp.png",
                "http://vision-poster.oss-cn-shanghai.aliyuncs.com/lllcho.lc/data/test_data/images/ref_edge/2c36cc4b7da027279e87311dac48fc2d5d784b1e72c0e-x4f1wC_fw658webp.png"
            ],
            "background_edge": [
                "http://vision-poster.oss-cn-shanghai.aliyuncs.com/lllcho.lc/data/test_data/images/ref_edge/0718a9741e07c52ca5506e75c4f2b99e22fff68a4c7d3-P9WGLr_fw658webp.png"
            ],
            "foreground_edge_prompt": [
                "粉色桃花",
                "可爱小狗"
            ],
            "background_edge_prompt": [
                "树叶"
            ]
        }
    },
    "parameters": {
        "n": 4,
        "ref_prompt_weight": 0.5,
        "model_version": "v3"
    }
}'
报错信息显示“请求Body格式无效”。 
{
    "request_id": "d306ae65-3f6d-9d6c-acfb-xxxxxx",
    "code": "InvalidParameter",
    "message": "Required body invalid, please check the request body format."
}
可能原因：创建任务接口的请求Body中存在中文字符。如果执行curl命令的客户端不支持解析中文，可能会导致请求Body解析异常，从而引发报错。 解决方案：macOS或者Linux系统用户直接在终端执行curl命令即可。Windows用户建议使用HTTP接口平台发送请求，如Postman、Apifox等。

海外调用API接口显示资源下载超时

报错场景：您在海外调用接口，且图片资源存储于非中国内地地域，较大概率出现资源下载超时报错，报错信息如下所示。 
Download the media resource timed out during the data inspection process
主要原因：非中国内地地区存在不稳定因素，因此在下载图片时会导致超时情况。 解决方案：请将图片资源存储在中国内地的地域，并配置加速。注意，当前不支持配置主账号的图片下载超时时间。

文生图生成的文字异常怎么办

问题场景：当您在Prompt中包含文字描述（如"海报上写着某某文字"）时，早期万相文生图模型（如wanx-v1、wanx2.0、wanx2.1系列）生成的图片中文字可能出现变形、乱码或无法正常显示的情况。 问题原因：早期万相文生图模型对文字渲染能力有限，在生成图片时无法准确渲染Prompt中指定的文字内容，这是模型能力的限制而非接口Bug。 解决方案：
  1. 推荐方案：使用支持文字渲染的模型。千问图像生成模型（如qwen-image-2.0-pro、qwen-image-plus）具备专业的文字渲染能力，能够准确生成Prompt中指定的文字内容。此外，万相2.5及以上版本（如Wan2.5-T2I-Preview）也支持中英文及小语种文字生成。
  2. 如果必须使用早期万相模型，建议先生成不含文字的图片，再使用图片编辑软件手动添加所需的文字内容。
使用 API
文本生成
图像生成
视频生成
音频
实时多模态
Realtime API
  • 概述
向量与排序
更多模型
工具包/框架
模型生产
文件管理
账单
更多