图像画面扩展API参考

步骤1：创建任务获取任务ID

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/out-painting

调用时请将{WorkspaceId}替换为真实的业务空间ID。

# 以下为华北2（北京）地域的URL，调用时请将 {WorkspaceId} 替换为真实的业务空间ID，各地域的URL不同。
curl --location --request POST 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/out-painting' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'X-DashScope-Async: enable' \
--header 'Content-Type: application/json' \
--data '{
    "model": "image-out-painting",
    "input": {
        "image_url": "http://xxx/image.jpg"
    },
    "parameters":{
        "angle": 45,
        "x_scale":1.5,
        "y_scale":1.5
    }
}'

# 以下为华北2（北京）地域的URL，调用时请将 {WorkspaceId} 替换为真实的业务空间ID，各地域的URL不同。
curl --location --request POST 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/out-painting' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'X-DashScope-Async: enable' \
--header 'Content-Type: application/json' \
--data '{
    "model": "image-out-painting",
    "input": {
        "image_url": "http://xxx/image.jpg"
    },
    "parameters":{
        "x_scale":2,
        "y_scale":2,
        "best_quality":false,
        "limit_image_size":true
    }
}'

# 以下为华北2（北京）地域的URL，调用时请将 {WorkspaceId} 替换为真实的业务空间ID，各地域的URL不同。
curl --location --request POST 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/out-painting' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'X-DashScope-Async: enable' \
--header 'Content-Type: application/json' \
--data '{
    "model": "image-out-painting",
    "input": {
        "image_url": "http://xxx/image.jpg"
    },
    "parameters": {
        "left_offset": 200,
        "right_offset": 100,
        "best_quality": false,
        "limit_image_size": true
    }
}'

# 以下为华北2（北京）地域的URL，调用时请将 {WorkspaceId} 替换为真实的业务空间ID，各地域的URL不同。
curl --location --request POST 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/out-painting' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'X-DashScope-Async: enable' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "image-out-painting",
    "input": {
        "image_url": "https://huarong123.oss-cn-hangzhou.aliyuncs.com/image/%E5%9B%BE%E5%83%8F%E7%94%BB%E9%9D%A2%E6%89%A9%E5%B1%95.png"
    },
    "parameters":{
        "angle":0,
        "output_ratio":"4:3",
        "best_quality":false,
        "limit_image_size":true
    }
}'

参数设置建议

1. 仅按宽高比扩图 ：只需设置 output_ratio，并将其设置为非空的宽高比值（如 "4:3"、"16:9" 等）。

2. 仅按比例扩图 ：只需设置x_scale、y_scale，且至少一个参数值大于 1.0，两者既可单独使用也可搭配使用。

3. 仅在指定方向添加像素扩图 ：只需设置 left_offset、right_offset、top_offset、bottom_offset，且至少有一个参数值大于 0。这四个参数既可单独使用也可搭配使用。

4. 仅旋转图像 ：只需设置 angle ，并将其设置为 [1, 359] 范围内的值，但不能设置为 90、180、270。

5. 先旋转再扩图：需要设置angle ，并将其设置为 [1, 359] 范围内的任意值。同时必须与以下三组扩展参数中的一组搭配使用。若同时设置多组扩展参数，按参数优先级生效。

   1. output_ratio：不为空。

   2. x_scale、y_scale：至少有一个大于 1.0。

   3. top_offset、bottom_offset、left_offset、right_offset：至少有一个参数值大于 0。

   注意 ：先旋转后扩图时，模型会先根据指定角度旋转图像，再在旋转后的图像上进行扩图操作。实际扩图效果请以模型输出为准。

参数优先级

• 当angle > 0且同时设置扩展参数时，处理顺序为：先旋转 → 后扩展。

• 当 angle = 0或图像完成旋转后，扩展参数按以下优先级生效：

  • 优先级1：按宽高比扩展（output_ratio）

    若 output_ratio 不为空，则按此宽高比生成图像，其他扩展参数均被忽略。

  • 优先级2：按比例扩展（x_scale、y_scale）

    若未设置 output_ratio，且 x_scale 和 y_scale 至少有一个参数值大于 1，则按此比例对图像进行扩展。此时，忽略添加像素扩展的相关参数。

  • 优先级3：在指定方向添加像素扩展（left_offset、right_offset、top_offset、bottom_offset）

    若未设置 output_ratio、x_scale、y_scale，且left_offset、right_offset、top_offset、bottom_offset至少有一个参数值大于0，则按此方式在指定方向添加像素扩图。

参数组合示例

错误码

如果模型调用失败并返回报错信息，请参见错误码进行解决。