本文為您介紹圖像生產（imageenhan）類目下的智能構圖IntelligentComposition的語法及示例。

功能描述

智能構圖能力通過對輸入圖像進行美學評估，智能輸出bounding box，根據這些bounding box可以將原圖裁剪成更好的圖像。

說明
  • 您可以進入在線咨詢獲取在線人工幫助。
  • 當前能力可在視覺智能開放平臺有完整的免費產品體驗，您可以單擊立即試用對該能力進行更直觀試用以及在線購買。
  • 阿里云視覺智能開放平臺視覺AI能力API接入、接口使用或問題咨詢等，請通過釘釘群（23109592）加入阿里云視覺智能開放平臺咨詢群聯系我們。

接入指引

1. 注冊阿里云賬號：打開阿里云官網，在阿里云官網右上角，單擊立即注冊，按照操作提示完成賬號注冊。

2. 開通能力：請確保您已開通圖像生產服務，若未開通服務請立即開通。

3. 創建AccessKey：請確保您已創建AccessKey，如果您使用的是子賬號AccessKey，您需要給子賬號賦予AliyunVIAPIFullAccess權限，具體操作，請參見RAM授權。

4. 在線調試（可選）：您可以通過OpenAPI Explorer在線調試能力，查看完整的調用示例代碼及SDK依賴信息，也可以下載完整的工程。

5. 開發接入步驟：

  • 在SDK總覽中選擇您要接入使用的SDK語言。
  • 在對應語言的SDK文檔中找到AI類目為圖像生產（imageenhan）的SDK包進行安裝。
  • 參考文檔中提供的示例代碼進行適當修改后調用。

6. 客戶端直接調用：該能力常用的客戶端調用方式包括以下幾種。

輸入限制

  • 圖像格式：JPEG、JPG、PNG、BMP、WEBP。
  • 圖像大小：小于3 MB。
  • 圖像分辨率：大于32×32像素。
  • URL中不能包含中文字符。

計費說明

關于智能構圖的計費方式及報價，請參見計費介紹。

說明 下方調試接口為付費接口，如需免費體驗調試請前往體驗中心。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 IntelligentComposition

系統規定參數。取值：IntelligentComposition。
NumBoxes Integer 否 5

輸出框的個數，默認值5，取值范圍1~10，小于或超出范圍會截斷取值。
ImageURL String 是 http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageenhan/IntelligentComposition/IntelligentComposition3.jpg

圖像URL地址。推薦使用上海地域的OSS鏈接，對于文件在本地或者非上海地域OSS鏈接的情況，請參見文件URL處理。

返回數據

名稱 類型 示例值 描述
RequestId String C1D52018-D67A-46AD-9AAA-031750A6E770

請求ID。
Data Object

返回的結果數據內容。
Elements Array of Element

智能構圖結果。
MinX Integer 43

輸出框的左上角橫坐標。
Score Float 3.6567564

輸出框的評分，取值范圍0~5。分數越高說明構圖效果越好，推薦3.8以上為較好構圖得分。
MaxY Integer 672

輸出框的右下角縱坐標。
MaxX Integer 981

輸出框的右下角橫坐標。
MinY Integer 96

輸出框的左上角縱坐標。

SDK參考

阿里云視覺AI圖像生產類目下的智能構圖能力推薦使用SDK調用，支持多種編程語言，調用時請選擇AI類目為圖像生產（imageenhan）的SDK包，文件參數通過SDK調用可支持本地文件及任意URL，具體可參見SDK總覽。

示例

請求示例

http(s)://imageenhan.cn-shanghai.aliyuncs.com/?Action=IntelligentComposition      //更多關于訪問域名（Endpoint）信息，請參見：http://bestwisewords.com/document_detail/143103.html
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/imageenhan/IntelligentComposition/IntelligentComposition3.jpg
&NumBoxes=5
&<公共請求參數>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>C1D52018-D67A-46AD-9AAA-031750A6E770</RequestId>
<Data>
    <Elements>
        <MaxX>981</MaxX>
        <MaxY>672</MaxY>
        <MinX>43</MinX>
        <Score>3.6567564</Score>
        <MinY>96</MinY>
    </Elements>
    <Elements>
        <MaxX>896</MaxX>
        <MaxY>736</MaxY>
        <MinX>43</MinX>
        <Score>3.594815</Score>
        <MinY>32</MinY>
    </Elements>
    <Elements>
        <MaxX>981</MaxX>
        <MaxY>736</MaxY>
        <MinX>43</MinX>
        <Score>3.5908668</Score>
        <MinY>32</MinY>
    </Elements>
    <Elements>
        <MaxX>981</MaxX>
        <MaxY>608</MaxY>
        <MinX>43</MinX>
        <Score>3.5745924</Score>
        <MinY>96</MinY>
    </Elements>
    <Elements>
        <MaxX>896</MaxX>
        <MaxY>672</MaxY>
        <MinX>43</MinX>
        <Score>3.5324287</Score>
        <MinY>96</MinY>
    </Elements>
</Data>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "C1D52018-D67A-46AD-9AAA-031750A6E770",
  "Data" : {
    "Elements" : [ {
      "MaxX" : 981,
      "MaxY" : 672,
      "MinX" : 43,
      "Score" : 3.6567564,
      "MinY" : 96
    }, {
      "MaxX" : 896,
      "MaxY" : 736,
      "MinX" : 43,
      "Score" : 3.594815,
      "MinY" : 32
    }, {
      "MaxX" : 981,
      "MaxY" : 736,
      "MinX" : 43,
      "Score" : 3.5908668,
      "MinY" : 32
    }, {
      "MaxX" : 981,
      "MaxY" : 608,
      "MinX" : 43,
      "Score" : 3.5745924,
      "MinY" : 96
    }, {
      "MaxX" : 896,
      "MaxY" : 672,
      "MinX" : 43,
      "Score" : 3.5324287,
      "MinY" : 96
    } ]
  }
}

錯誤碼

關于智能構圖的錯誤碼，詳情請參見常見錯誤碼。

安全聲明

  • 請確保上傳的圖片或文件來源符合相應的法律法規。
  • 通過體驗調試上傳的臨時文件有效期為1小時，在24小時后會被系統自動清理刪除。