当需调整图片尺寸以适配特定布局,或在不裁剪主体的前提下拓宽视野时,可使用图像画面扩展模型。该模型支持多种扩图方式:
- 指定宽高比扩图
- 指定横向或纵向扩展比例
- 自定义上下左右各方向扩展像素数
- 同时支持先旋转再扩图
模型与价格
模型名称 | 计费单价 | 限流(主账号与RAM子账号共享) | 免费额度(查看) | |
|---|---|---|---|---|
任务下发接口QPS限制 | 同时处理中任务数量 | |||
image-out-painting | 0.18元/张 | 2 | 5 | 500张 |
模型效果
原图 | |||
![]() | |||
旋转扩图 (逆时针旋转90度) | 等比例扩图 (1.5:1.5) | 指定方向添加像素扩图 (上下左右添加像素) | 指定宽高比扩图 (4:3) |
![]() | ![]() | ![]() | ![]() |
快速开始
前提条件
您需要已获取与配置 API Key并配置API Key到环境变量。
扩图建议:为了获得更自然的扩展效果,建议将最终输出图像的宽高比控制在接近1:1的范围内。例如,从 1000x1000 扩展到 1500x1500 的效果,通常优于扩展到 2000x1000。
示例代码
本模型仅提供 HTTP API,请参考curl示例代码。
调用时请将{WorkspaceId}替换为真实的业务空间ID。
- curl
- Python
HTTP调用新手指南请参见Postman。
步骤1:创建任务获取任务ID
接口返回任务ID,可根据任务ID查询图像生成的结果。请求示例task_id的查询有效期为 24 小时。步骤2:查询任务结果
使用步骤1中获取的task_id,通过 GET 请求轮询任务查询接口,直到task_status变为 SUCCEEDED。任务成功后,响应中会包含生成的图像 URL。请求示例请将86ecf553-d340-4e21-xxxxxxxxx替换为真实的task_id。若使用新加坡地域的模型,需将base_url替换为https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx,其中{WorkspaceId}需替换为真实的业务空间ID。
图像URL有效期为24小时,请及时下载图像。
更多扩图示例
按宽高比扩图
| 原图 | 扩图后 | 扩图参数 |
![]() | ![]() | |
按比例扩图
| 原图 | 扩图后 | 扩图参数 |
![]() | ![]() | |
![]() | ![]() | |
![]() | ![]() | |
![]() | ![]() |
按方向添加像素扩图
| 原图 | 扩图后 | 扩图参数 |
![]() | ![]() | |
![]() | ![]() | |
![]() | ![]() |
旋转扩图
| 原图 | 扩图后 | 扩图参数 |
![]() | ![]() | |
API参考
关于图像画面扩展模型的输入输出参数,请参见图像画面扩展API。
错误码
如果模型调用失败并返回报错信息,请参见错误码进行解决。
常见问题
Q:调用 API 时返回错误,可能是什么原因?
A:请检查以下几点:
- API Key 是否正确,并且已配置到环境变量或代码中。
- API Key 所在地域与调用的服务地址(Endpoint)是否匹配。
- 检查免费额度是否已用尽。
- 请求参数是否正确,例如
image_url是否可公网访问。本地文件请参见上传文件获取临时URL。
RUNNING状态?
A:图像生成需要一定时间,通常在数十秒内完成。如果任务长时间未完成,可能是因为系统繁忙。如果超过数分钟仍未完成,请检查服务状态或联系技术支持。





















