2022AI商品圖接口調(diào)用OpenAPI

AI商品圖OpenAPI一、核心邏輯業(yè)務(wù)流程交互方案一（異步輪詢結(jié)果）交互方案二（異步推送結(jié)果）二、接口文檔接口地址：通用說明Content-Type:application/json通用查詢字符串參數(shù)（QueryStringParameters）參數(shù)名類型是否必須示例值說明通用錯誤碼和錯誤信息錯誤碼錯誤信息說明10007接口不存在請注意請求方式GET或者POST11002系統(tǒng)錯誤11001access_key不存在具體的參數(shù)錯誤信息錯誤返回示例{"reqid":"","code":10007,"message":"接口不存在"}接口列表推薦場景列表GET/design/enterprise/ai_product/materials參數(shù)列表參數(shù)名類型是否必須示例值說明cursorstring否xxxx游標(biāo)，默認(rèn)為空countint否20每次返回的條數(shù)返回值示例{"reqid":"e6c93dfd-9367-446d-b8e8-2f56a490298f","code":0,"data":{"cursor":"39e712720d81f29e4dae942b9bd633fb","data":[{"default_name":"水花飛濺","id":1684899118076019,"thumbnail":{"height":1024,"url":"/material/image/646d8529de7056021.png","width":1024}}]}}返回值說明參數(shù)名類型說明cursorstring下一頁的游標(biāo)，為空則說明已經(jīng)是最后一頁default_namestring場景名稱idint場景素材idthumbnailobject預(yù)覽圖信息urlstring文件地址widthint圖片寬度heightint圖片高度按風(fēng)格分類的推薦場景列表GET/design/enterprise/ai_product/style_materials返回值示例{"reqid":"ab420552-1239-4e27-9408-62c8e519b5a5","code":0,"data":[{"id":2614,"materials":[{"default_name":"家居大理石","id":1680610185410508,"prompt_id":"10045","thumbnail":{"height":1024,"url":"/material/image/6476c2a00df2e6161.png","width":1024}}],"name":"大理石"}]}返回值說明參數(shù)名類型說明idint分類idnamestring風(fēng)格名稱materials[].idint場景idmaterials[].default_namestring場景名稱materials[].thumbnailobject預(yù)覽圖信息materials[].thumbnail.urlstring文件地址materials[].thumbnail.widthint圖片寬度materials[].thumbnail.heightint圖片高度文本描述示例列表GET/design/enterprise/ai_product/desc_list一些自定義描述的示例返回值示例{"reqid":"d8643142-747b-4bcf-82a8-488f8873a997","code":0,"data":[{"id":1688554224161139,"default_name":"絲綢綢緞-自定義","prompt":"放在絲綢背景中，波浪的面料，柔和顏色，奢華質(zhì)感"}]}返回值說明參數(shù)名類型說明default_namestring下一頁的游標(biāo)，為空則說明已經(jīng)是最后一頁idint場景名稱promptstring場景自定義中文描述示例顯著性檢測摳圖接口POST/design/enterprise/ai_product/sodTODO:顯著性檢測的封裝返回?fù)笀Dmask和box1參數(shù)，完整的摳圖需要接入顯著性檢測和萬物摳圖如果不進(jìn)行商品位置或者大小的調(diào)整則無需摳圖，創(chuàng)建任務(wù)的接口可以自動摳圖參數(shù)說明參數(shù)名類型是否必須示例值說明urlstring是/ai_product/6423ad79aaf5be9661nd3m5661.jpeg待摳圖的圖片地址響應(yīng)示例{"reqid":"8ade0ca1-e85b-4455-88f1-d922f564ca8d","code":0,"data":{"height":161,"url":"/mtopen/DDUY4XTGIWSTXHcdXtZlKUs5Jid5O8Il/MTY4NjI5MDQwMA==/255df2be-1d80-4d78-9cc1-1cf3f12fa231.jpg","width":371,"x":439,"y":359}}返回值說明參數(shù)名類型說明urlstring摳圖mask文件地址，后續(xù)流程創(chuàng)建任務(wù)（create接口）的時候，可用于設(shè)置mask_urlxint摳圖mask框左上角的點(diǎn)相對于原圖的x坐標(biāo)yint摳圖mask框左上角的點(diǎn)相對于原圖的y坐標(biāo)widthint摳圖mask框的寬度，如圖heightint摳圖mask框的高度，如圖，以上四個值組成創(chuàng)建任務(wù)接口的box1參數(shù)，用逗號隔開，x,y,width,height如何理解參數(shù)box1，box2？任務(wù)投遞接口POST/design/enterprise/ai_product/create參數(shù)列表參數(shù)名類型是否必須示例值說明urlstring是/ai_product/6423ad79aaf5be9661nd3m5661.jpeg商品圖地址mask_urlstring是/mtopen/DDUY4XTGIWSTXHcdXtZlKUs5Jid5O8Il/MTY4NjI5MDQwMA==/f044bd2d-3ae4-488a-86a0-b63a3c8ef665.jpg商品圖摳圖mask地址，調(diào)用sod接口得到的urlbox1string是439,359,161,371調(diào)用sod接口得到的坐標(biāo)和寬高數(shù)據(jù)，用逗號隔開，x,y,width,heightbox2string否168.5,217.5,175,77x,y,w,h，x,y是商品圖在canvas_w*canvas_h畫布上的外框的坐標(biāo)w,h為商品圖寬高，用于調(diào)整商品的大小和在畫布中的位置，如下詳解。不傳則自動居中material_idstring否1680609393883371場景素材id，多個用逗號隔開，注意這個字段是字符串格式！product_categorystring否shoes商品類別英文，默認(rèn)為productcallback_urlstring否/path/to/callback提供post接口地址，接收回調(diào)信息scene_typenumber是11推薦場景（material_id必填）2自定義場景（prompt必填），默認(rèn)為1promptstring是夏天的足球場自定義場景canvas_wnumber否512畫布寬度，是生成圖寬度的一半，默認(rèn)512，則生成圖邊長為1024，步長為0.5，小數(shù)位只支持0.5，范圍在50和1024之間canvas_hnumber否512畫布高度，是生成圖高度的一半，默認(rèn)512，則生成圖邊長為1024，步長為0.5，小數(shù)位只支持0.5，范圍在50和1024之間anglenumber否0旋轉(zhuǎn)角度，按逆時針旋轉(zhuǎn)，范圍為0-360，注意：使用angle時，box2框信息必須為旋轉(zhuǎn)操作之前信息，即box2表示平移縮放，angle表示旋轉(zhuǎn)flipnumber否0商品圖鏡像操作，默認(rèn)為0，0不做鏡像，1左右鏡像，2上下鏡像3左右+上下鏡像box2參數(shù)詳解x,y是如圖中箭頭指示框相對于整個畫布的坐標(biāo)，畫布寬高為512,512x,y參數(shù)影響商品在生成圖片中的位置，可以拖動移動位置widthheight是商品本身的屬性widthheight決定商品的大小，計算方式為初始值為摳圖mask框的寬高，（如調(diào)用sod接口進(jìn)行摳圖，則返回值中的widthheight就是這兩個參數(shù)）對商品進(jìn)行縮小放大則乘以縮放比例sacle用戶上傳的圖片最大的邊如果大于256（畫布的一半），則應(yīng)該縮小到256以獲得更好的效果響應(yīng)示例{"reqid":"a061d888-1250-424a-95ba-179c9d4ccb76","code":0,"data":{"id":1869009,"url":"/ai_product/2b98e52365f0dc631f4f6cf7a043c606.jpeg","result_image_urls":[],"process_status":1,"finished_at":0,"created_at":1685607926,"updated_at":1685607926}}返回值說明參數(shù)名類型說明idstring商品創(chuàng)建任務(wù)idurlstring商品圖原圖地址result_image_urlsstring結(jié)果圖列表process_statusstring任務(wù)狀態(tài)1進(jìn)行中2成功3失敗finished_atint完成時間created_atint創(chuàng)建時間updated_atint更新時間任務(wù)查詢接口GET/design/enterprise/ai_product/query參數(shù)說明參數(shù)名類型示例值說明idnumber100001商品圖任務(wù)id可以輪詢該接口直到process_status=2，任務(wù)完成。任務(wù)完成時間一般在5秒以內(nèi)，目前設(shè)置是60秒（暫定，可能調(diào)整）超時失敗，可以一直輪詢到出結(jié)果。獲取到任務(wù)的結(jié)果要立即自行保存，圖片要轉(zhuǎn)存。響應(yīng)示例{"reqid":"a061d888-1250-424a-95ba-179c9d4ccb76","code":0,"data":{"id":1869009,"url":"/ai_product/2b98e52365f0dc631f4f6cf7a043c606.jpeg","result_image_urls":["/ai_product_photo/647855f9782533669xKEMvKj7o2675.png","/ai_product_photo/647855f9329792026VoZeP6uRY8569.png","/ai_product_photo/647855f9373928684XqtWdDMHT6756.png","/ai_product_photo/647855f9472929716BkOehSsUU8208.png"],"process_status":2,"finished_at":1685607929,"created_at":1685607926,"updated_at":0}}返回值說明參數(shù)名類型說明idstring商品創(chuàng)建任務(wù)idurlstring商品圖原圖地址result_image_urlsstring結(jié)果圖列表process_statusstring任務(wù)狀態(tài)1進(jìn)行中2成功3失敗finished_atint完成時間created_atint創(chuàng)建時間updated_atint更新時間回調(diào)接口要求POST類型的接口，接收content-type:application/json的數(shù)據(jù)回調(diào)請求參數(shù)如下{"id":1869009,"url":"/ai_product/2b98e52365f0dc631f4f6cf7a043c606.jpeg","result_image_urls":["/ai_product_photo/647855f9782533669xKEMvKj7o2675.png","/ai_product_photo/647855f9329792026VoZeP6uRY8569.png","/ai_product_photo/647855f9373928684XqtWdDMHT6756.png","/ai_product_photo/647855f9472929716BkOehSsUU8208.png"],"process_status":2,"finished_at":1685607929,"created_at":1685607926,"updated_at":1685607929}返回值說明參數(shù)名類型說明idstring商品創(chuàng)建任務(wù)idurlstring商品圖原圖地址result_image_urlsstring結(jié)果圖列表process_statusstring任務(wù)狀態(tài)1進(jìn)行中2成功3失敗finished_atint完成時間created_atint創(chuàng)建時間updated_atint更新時間三、簽名規(guī)則開放平臺接口簽名四、調(diào)用頻率聯(lián)調(diào)測試QPS<=3正式環(huán)境QPS<=3美圖設(shè)計室：AI拼圖和海報OpenAPI一、接口說明接口地址/design/ai_poster/puzzle_generate_urls請求方式Content-Type:application/jsonMethod:POST請求參數(shù)說明請求參數(shù)示例{"origin_img":["/poster/6502a845c8dcdvlsjdl8h19420.jpg","/poster/6502a845c8dd442tjwe3hf1023.jpg","/poster/6502a845c8dd5jjgjj620k4445.jpg","/poster/6502a845c8dccvutvgghkm3538.jpg"],"sale_point":["價格美麗","質(zhì)量過硬","好東西"]}參數(shù)名類型說明origin_img[]string原圖地址列表，限制1-5張圖，建議原圖大小限制在4Mb以內(nèi)，算法處理速度會有比較好的效果sale_point[]string賣點(diǎn)列表，可選傳值，最多支持3個賣點(diǎn)返回值說明返回值示例{"reqid":"aeb2eca2-0087-4fdb-9a1a-c41ebdc5cbb2","code":0,"data":{"k2_req_id":"aebaeb2ec2-0087-4fdb-9a1a-cefsfd","urls":["/poster/5c5a7106eaf3f7ad57a207616cef8d98.jpg","/poster/e37fbcbe4bfe7fc0056ce397c783da1f.jpg","/poster/90fe06474c4a46a23da4a7d8d13eb26a.jpg","/poster/c20d70c8fc558ac29ba843c1f89a0e63.jpg","/poster/bdf8e3f96a4d2fd6ad63d1b2e280edde.jpg","/poster/da5f35946af49232f84f1d3756b6ee95.jpg","/poster/8f8df8cc7fc68ee29c6c3a2febc8378a.jpg","/poster/b963721af0b451503de3f0126655c6fc.jpg","/poster/701a5cb716a52b0d648486c89018b353.jpg","/poster/792ec27b8a0e5ac999ca8a451e095342.jpg"]}}參數(shù)名類型說明reqidstring鏈路traceID，用于排障日志定位codeint接口響應(yīng)狀態(tài)碼，code>0表示接口處理失敗messagestring當(dāng)code>0時會有相關(guān)描述錯誤信息返回dataobject接口返回具體業(yè)務(wù)內(nèi)容data.urls[]stringAI拼圖結(jié)果頁圖片url，圖片地址為7天有效的云存儲地址data.k2_req_idstring算法執(zhí)行鏈路traceID，用于排障日志定位通用錯誤碼和錯誤信息錯誤碼錯誤信息說明10007接口不存在請注意請求方式GET或者POST11002系統(tǒng)錯誤具體的參數(shù)錯誤信息11001參數(shù)異常具體的參數(shù)錯誤信息錯誤返回示例{"reqid":"","code":10007,"message":"接口不存在"}二、簽名規(guī)則開放平臺接口簽名三、調(diào)用頻率聯(lián)調(diào)測試QPS<=3正式環(huán)境QPS<=3QPS實(shí)際頻率取決商戶合作協(xié)議美圖設(shè)計室：智能摳圖描述本接口用于云端進(jìn)行顯著性檢測摳圖，具體效果請看以下文檔詳情。建議原圖大小控制在3M以內(nèi)能保證比較好的摳圖速度。版本1.0圖片要求圖片格式：JPG，PNG調(diào)用URL/api/v1/sdk/sync/push簽名驗(yàn)證開放平臺接口簽名調(diào)用方法POSTrequest的頭的類型應(yīng)包含：Content-Type:application/json權(quán)限使用前需提前申請AccessKey和secret，具體獲取，請對接商務(wù)請求參數(shù)輸入值示例"{\"sync_timeout\":10,\"task_type\":\"mtlab\",\"init_images\":[{\"url\":\"/Marvel/1687154827715.png\"}],\"task\":\"v1/sod\",\"params\":\"{\\\"parameter\\\":{\\\"rsp_media_type\\\":\\\"url\\\"}}\"}"參數(shù)說明Jsonencode(基本參數(shù)Object)作為HTTP請求Body參數(shù)基本參數(shù)是否必選參數(shù)名類型參數(shù)說明必選sync_timeoutInterger請求超時時間，單位秒必選task_typeString任務(wù)類型，固定“mtlab”必選init_imagesObject原始圖片地址必選taskString任務(wù)地址，固定“v1/sod”必選paramsString額外參數(shù)的json信息params中的parameter細(xì)分參數(shù)說明是否必選參數(shù)名類型參數(shù)說明可選rsp_media_typeString“url”：摳圖結(jié)果以短期有效的url返回可選nMaskbool是否返回mask圖，True只返回mask圖，F(xiàn)alse返回結(jié)果圖可選model_typeint選擇要使用的摳圖模型，傳0：表示使用人像摳圖；傳1：表示使用商品摳圖；傳2：表示使用圖形摳圖。若不傳，模型內(nèi)部會自動判斷選擇使用哪個模型可選userboxesstring圖標(biāo)類型可以添加用戶交互框參數(shù)，坐標(biāo)應(yīng)當(dāng)使用相對坐標(biāo)，示例：[[[0.01,0.814],[0.12,0.814],[0.12,0.96],[0.01,0.96]]可選blackwhitebool是否返回黑白圖，True只返回黑白mask圖，F(xiàn)alse返回四通道Mask圖，默認(rèn)為False可選nboxbool是否返回目標(biāo)位置，True返回目標(biāo)位置top_x,top_y,bottom_x,bottom_y,默認(rèn)為False返回值說明ResponseStatus：200content-type為application/json;charset=utf-8請求成功返回示例{"code":0,"data":{"status":10,"result":{"id":"1cc79381-d367-4630-a7bc-0633fbc72637","urls":["/mtopen/7071f5094b73406da8db0136fc1f7831/MTY4OTgzNjQwMA==/50a84e28-d3e9-453b-b486-da758c5b88cd.jpg"],"parameters":{"Kind":0,"bottom_x":"None","bottom_y":"None","exist_salient":true,"process_time":120.13816833496094,"pull_time":88.46640586853027,"rsp_media_type":"url","top_x":"None","top_y":"None","use_fe":true,"version":"2.4.0"}},"progress":1,"predict_elapsed":10000}}成功返回值說明字段類型參數(shù)說明codeIntergercode=0時表示請求成功，code>0表示請求失敗dataObject返回任務(wù)處理詳情data中字段說明字段類型參數(shù)說明statusInterger任務(wù)處理狀態(tài)：9=超時，2=失敗，10=成功resultObject任務(wù)處理結(jié)果內(nèi)容progressInterger任務(wù)進(jìn)度data.result中字段說明字段類型參數(shù)說明idString任務(wù)IDurlsString處理結(jié)果圖片集parametersObject額外返回參數(shù)data.result.urls中字段說明字段類型參數(shù)說明outimg（index=0的圖）String結(jié)果圖片data.result.parameters中字段說明bottom_xstring右下角X坐標(biāo)bottom_ystring右下角Y坐標(biāo)exist_salientbool表示是否有顯著性目標(biāo)Kindint0：表示人像；1：表示商品；2：表示圖形rsp_media_typeString‘jpg’，表示media_data是經(jīng)過base64壓縮過的圖片top_xstring左上角X坐標(biāo)top_ystring左上角Y坐標(biāo)use_febooltrue:表示需要使用前景估計，false:表示不需要使用前景估計versionString版本號失敗返回值說明字段類型說明ErrorCodeInt錯誤代碼ErrorMsgString錯誤信息DataString具體信息返回值示例返回值示例請求失敗返回示例ResponseStatus：200content-type為application/json;charset=utf-8{"code":20001,"message":"PROCESS_ERROR","data":{"status":2,"result":{"id":"c7cad452-720e-4766-a448-23dab39789d9","code":20001},"progress":1}}當(dāng)前API特有的錯誤代碼與信息ErrorCode狀態(tài)代碼錯誤信息說明20001PROCESS_ERROR處理錯誤20003DETECT_NOT_FACE人臉缺失20004MORE_THAN_ONE_FACE人臉數(shù)大于120007MISSING_LANDMARK_ARGUMENTS未傳入人臉點(diǎn)20008UNSUITABLE_IMAGE照片不符合規(guī)范20009UNSUPPORT_TYPE不支持的type20010DETECT_NOT_FACE檢測不到第二張圖片的人臉20011UNSUITABLE_VERTICAL_IMAGE垂直高度不滿足20012UNSUITABLE_HORIZONTAL_IMAGE水平寬度不滿足20013RESOLUTION_TOO_LARGE_ERROR分辨率過大20014NOT_FOUND查找不到圖片20015PICTURE_OVERRUN_ERROR圖片超限20020DETECT_FACE_OUTOFIMAGE五官缺失20021DETECT_FACE_PITCHANGLE_BIG非正臉點(diǎn)頭俯仰角過大20022DETECT_FACE_YAWANGLE_BIG非正臉搖頭旋轉(zhuǎn)角過大20023DETECT_FACE_LOWAREA臉部占比小像素低21001LOAD_MODEL_ERROR加載模型失敗21002HAIR_MASK_LOSS頭發(fā)mask缺失21003FACE_NUM_ERROR人臉個數(shù)錯誤21004AR_PARSE_FAULTar中plist解析錯誤21005AR_EEEOR_COUNTar人臉錯誤21006AR_FACE_OUTar超過人臉范圍21007JSON_ERRORjson內(nèi)容錯誤21008BACKGROUND_IMAGE_LOSS背景圖片缺失21009BODY_MASK_LOSSbodymask缺失21010FACE_ANGLE_ERROR人臉角度錯誤21011SKIN_MASK_LOSSskinmask缺失21012BODY_INFO_LOSS骨骼點(diǎn)或者外輪廓點(diǎn)缺失21013RECT_OUT_IMAGE超過圖片范圍通用的錯誤代碼與信息HTTP返回碼返回碼錯誤信息說明200成功的請求成功的請求400錯誤的請求錯誤的請求，通常為照片不符合規(guī)范等401鑒權(quán)失敗鑒權(quán)失敗，出現(xiàn)此錯誤時，請檢查您的AKSK是否正確403鑒權(quán)失敗鑒權(quán)失敗，出現(xiàn)此錯誤時，請檢查您的應(yīng)用是否過期404請求的接口錯誤請求的接口地址錯誤，請檢查請求的接口地址是否正確424下載圖片失敗下載圖片失敗，請確認(rèn)您使用的圖片URL地址是否能正常下載433請求實(shí)體過長請求實(shí)體過長，請檢查您的圖片是否超過接口限制415算法內(nèi)部異常算法內(nèi)部異常，請稍后重試500請求異常請求內(nèi)部異常，請稍后重試502無響應(yīng)請求無響應(yīng)，請稍后重試503并發(fā)過高請求并發(fā)超過限制504請求異常請求內(nèi)部異常，請稍后重試599請求超時請求超時，請稍后重試網(wǎng)關(guān)網(wǎng)關(guān)相關(guān)錯誤碼，通常是鑒權(quán)錯誤ErrorCode錯誤信息說明90000GATEWAY_INVALID_PARAMETER錯誤的入?yún)?，入?yún)⒔壎ㄊ?0001GATEWAY_PARAMETER_ERROR錯誤的入?yún)⒅?，對入?yún)⒉僮饕鸬腻e誤90002GATEWAY_AUTHORIZED_ERROR鑒權(quán)出錯90003GATEWAY_AUTHORIZED_NOT_MATCH鑒權(quán)匹配錯誤90005GATEWAY_AUTHORIZED_NOT_ACCEPTABLE鑒權(quán)不可用90004GATEWAY_INVALID_FORMFILE錯誤的表單文件，表單文件提取失敗90006GATEWAY_FORMAT_HEADERS_ERROR格式化頭部異常90007GATEWAY_FORMAT_BODY_ERROR格式化body異常90008GATEWAY_FORMAT_PARAMS_ERROR格式化params異常90009GATEWAY_TIMEOUT請求超時90010GATEWAY_JSON_MARSHAL_ERRORJSON編碼錯誤90011GATEWAY_JSON_UNMARSHAL_ERRORJSON解碼錯誤90012GATEWAY_BASE64_ENCODE_ERRORBASE64編碼錯誤90013GATEWAY_BASE64_DECODE_ERRORBASE64解碼錯誤90014GATEWAY_NOT_FOUND查找不到數(shù)據(jù)90015GATEWAY_FOUND_ERROR數(shù)據(jù)查詢異常90016GATEWAY_PUSH_QUEUE_ERROR隊列推送異常90017GATEWAY_GET_BODY_ERRORbody讀取異常90020GATEWAY_REQUEST_FORWARD_ERROR請求算法的處理異常90021GATEWAY_FORWARD_RESPONSE_ERROR算法響應(yīng)處理異常90022GATEWAY_ALGORITHM_DISABLE算法不可用90023GATEWAY_QUEUE_RESPONSE_ERROR算法隊列響應(yīng)異常90024GATEWAY_QPS_LIMIT超過當(dāng)前限制qps90099GATEWAY_UNKNOWN_ERROR未知錯誤算法通用錯誤碼ErrorCode錯誤信息說明10000INVALID_PARAMETER錯誤的參數(shù)10002REQUEST_TIMEOUT請求超時10003IMAGE_DOWNLOAD_FAILED圖片下載失敗10004TASK_NOEXIST任務(wù)不存在10005SO_ERRORso庫錯誤10006CONTENT_ERROR內(nèi)容錯誤10007DECODE_IMAGE_ERROR圖片解碼錯誤10008ENCODE_IMAGE_ERROR圖片編碼錯誤10009PROCESS_IMAGE_ERROR圖片處理錯誤10010LENTP_ERRORLentp圖片解析錯誤10011SHARE_ERROR共享內(nèi)存錯誤10012IMAGE_LENGTH_ERROR圖片長度接收錯誤10013BASE64_DECODE_ERRORBase64解碼錯誤10014URLDECODE_ERRORUrlDecode解碼錯誤10015RESOURCE_ERRORGPU/顯存資源不足，服務(wù)臨時不可用10016SLICE_IMAGE_ERROR圖片分塊錯誤10017MERGE_IMAGE_ERROR圖片塊合并錯誤10018FPGA_PROCESS_ERRORFPGA處理錯誤10019FPGA_PROCESS_TIMEOUTFPGA處理超時10024UNKNOWN_ERROR未知錯誤算法特有錯誤碼匯總ErrorCode狀態(tài)代碼錯誤信息說明20001PROCESS_ERROR處理錯誤20003DETECT_NOT_FACE人臉缺失20004MORE_THAN_ONE_FACE人臉數(shù)大于120007MISSING_LANDMARK_ARGUMENTS未傳入人臉點(diǎn)20008UNSUITABLE_IMAGE照片不符合規(guī)范20009UNSUPPORT_TYPE不支持的type20010DETECT_NOT_FACE檢測不到第二張圖片的人臉20011UNSUITABLE_VERTICAL_IMAGE垂直高度不滿足20012UNSUITABLE_HORIZONTAL_IMAGE水平寬度不滿足20013RESOLUTION_TOO_LARGE_ERROR分辨率過大20014NOT_FOUND查找不到圖片20015PICTURE_OVERRUN_ERROR圖片超限20020DETECT_FACE_OUTOFIMAGE五官缺失20021DETECT_FACE_PITCHANGLE_BIG非正臉點(diǎn)頭俯仰角過大20022DETECT_FACE_YAWANGLE_BIG非正臉搖頭旋轉(zhuǎn)角過大20023DETECT_FACE_LOWAREA臉部占比小像素低20024MASK_NOT_ENOUGH檢測到人數(shù)不足20025INIT_FAIL初始化失敗20026NO_SUCH_MODE沒有此模式20027TOO_SMALL_AREA可貼圖區(qū)域過小20028NO_MATERIALS_TO_PASTE可貼素材數(shù)量為零20029TOO_SMALL_SIZE素材尺寸太小20030WRONG_DIRECT方向參數(shù)錯誤20031TOO_BIG_DENSITY密度太大20032NO_CATS_OR_DOGS沒有檢測到貓狗20033skythresholdtoolow沒有檢測到天空區(qū)域21001LOAD_MODEL_ERROR加載模型失敗21002HAIR_MASK_LOSS頭發(fā)mask缺失21003FACE_NUM_ERROR人臉個數(shù)錯誤21004AR_PARSE_FAULTar中plist解析錯誤21005AR_EEEOR_COUNTar人臉錯誤21006AR_FACE_OUTar超過人臉范圍21007JSON_ERRORjson內(nèi)容錯誤21008BACKGROUND_IMAGE_LOSS背景圖片缺失21009BODY_MASK_LOSSbodymask缺失21010FACE_ANGLE_ERROR人臉角度錯誤21011SKIN_MASK_LOSSskinmask缺失21012BODY_INFO_LOSS骨骼點(diǎn)或者外輪廓點(diǎn)缺失21013RECT_OUT_IMAGE超過圖片范圍21014DETECT_NO_BODYbodymask為空21015AGE_INFO_LOSS缺少年齡數(shù)據(jù)21016GENDER_INFO_LOSS缺少性別數(shù)據(jù)21017CSKETCH_TYPE_ERROR線稿type錯誤21018CSKETCH_STRING_ERROR線稿外部傳入字符串錯誤21019CSKETCH_INVALID_NICKNAME表示用戶昵稱中存在無效字符21020CSKETCH_NULL_INPUT_STRING表示用戶昵稱中存在無效字符美圖設(shè)計室：智能消除描述本接口用于云端處理給智能消除的請求，具體效果請看以下文檔詳情。版本1.0圖片要求圖片格式：JPG，PNG調(diào)用URL/api/v1/sdk/sync/push簽名驗(yàn)證開放平臺接口簽名調(diào)用方法POSTrequest的頭的類型應(yīng)包含：Content-Type:application/json權(quán)限使用前需提前申請AccessKey和secret，具體獲取，請對接商務(wù)請求參數(shù)輸入值示例"{\"sync_timeout\":10,\"task_type\":\"mtlab\",\"init_images\":[{\"url\":\"/ai_eliminate/d566c86639e7d2aba222501091bb654a.png\"},{\"url\":\"/ai_eliminate/e70f4dc4d92219d9b6dd68b3483de456.png\"}],\"task\":\"v1/znxc\",\"params\":\"{\\\"parameter\\\":{\\\"rsp_media_type\\\":\\\"url\\\",\\\"model_type\\\":\\\"lama\\\",\\\"use_sod\\\":\\\"true\\\"}}\"}"參數(shù)說明Jsonencode(基本參數(shù)Object)作為HTTP請求Body參數(shù)基本參數(shù)是否必選參數(shù)名類型參數(shù)說明必選sync_timeoutInterger請求超時時間，單位秒必選task_typeString任務(wù)類型，固定“mtlab”必選init_imagesObject原始圖片地址。若采用不規(guī)則形狀(涂抹)方式傳參,需要傳兩張圖，第一張是原圖，第二張是Mask圖（要消除的范圍）必選taskString任務(wù)地址，固定“v1/znxc”必選paramsString額外參數(shù)的json信息params中的parameter細(xì)分參數(shù)說明是否必選參數(shù)名類型參數(shù)說明可選rsp_media_typeString“url”：結(jié)果返回短期有效的url地址可選userboxesString用戶交互框，注意使用相對坐標(biāo)，四個點(diǎn)表示交互框的四個點(diǎn)坐標(biāo)(左上起順時針)，若采用涂抹方式此參數(shù)失效。參數(shù)舉例：[[[0.02703101,0.07283443],[0.47267377,0.57283443],[0.47267377,0.76968473],[0.02703101,0.06968473]]]可選use_sodString是否對框選區(qū)域使用顯著性分割，若采用涂抹方式此參數(shù)失效可選model_typeString選擇使用的填充模型"lama",“fcf”返回值說明ResponseStatus：200content-type為application/json;charset=utf-8請求成功返回示例{"code":0,"data":{"status":10,"result":{"id":"260dfe6f-c398-4dff-a798-d956336372cb","urls":["outimg.jpg"]},"progress":1,"predict_elapsed":10000}}成功返回值說明字段類型參數(shù)說明codeIntergercode=0時表示請求成功，code>0表示請求失敗dataObject返回任務(wù)處理詳情data中字段說明字段類型參數(shù)說明statusInterger任務(wù)處理狀態(tài)：9=超時，2=失敗，10=成功resultObject任務(wù)處理結(jié)果內(nèi)容progressInterger任務(wù)進(jìn)度data.result中字段說明字段類型參數(shù)說明idString任務(wù)IDurlsString處理結(jié)果圖片集data.result.urls中字段說明字段類型參數(shù)說明outimg（index=0的圖）String結(jié)果圖片失敗返回值說明字段類型說明ErrorCodeInt錯誤代碼ErrorMsgString錯誤信息DataString具體信息返回值示例返回值示例請求失敗返回示例ResponseStatus：200content-type為application/json;charset=utf-8{"code":20001,"message":"PROCESS_ERROR","data":{"status":2,"result":{"id":"c7cad452-720e-4766-a448-23dab39789d9","code":20001},"progress":1}}當(dāng)前API特有的錯誤代碼與信息ErrorCode狀態(tài)代碼錯誤信息說明20001PROCESS_ERROR處理錯誤20003DETECT_NOT_FACE人臉缺失20004MORE_THAN_ONE_FACE人臉數(shù)大于120007MISSING_LANDMARK_ARGUMENTS未傳入人臉點(diǎn)20008UNSUITABLE_IMAGE照片不符合規(guī)范20009UNSUPPORT_TYPE不支持的type20010DETECT_NOT_FACE檢測不到第二張圖片的人臉20011UNSUITABLE_VERTICAL_IMAGE垂直高度不滿足20012UNSUITABLE_HORIZONTAL_IMAGE水平寬度不滿足20013RESOLUTION_TOO_LARGE_ERROR分辨率過大20014NOT_FOUND查找不到圖片20015PICTURE_OVERRUN_ERROR圖片超限20020DETECT_FACE_OUTOFIMAGE五官缺失20021DETECT_FACE_PITCHANGLE_BIG非正臉點(diǎn)頭俯仰角過大20022DETECT_FACE_YAWANGLE_BIG非正臉搖頭旋轉(zhuǎn)角過大20023DETECT_FACE_LOWAREA臉部占比小像素低21001LOAD_MODEL_ERROR加載模型失敗21002HAIR_MASK_LOSS頭發(fā)mask缺失21003FACE_NUM_ERROR人臉個數(shù)錯誤21004AR_PARSE_FAULTar中plist解析錯誤21005AR_EEEOR_COUNTar人臉錯誤21006AR_FACE_OUTar超過人臉范圍21007JSON_ERRORjson內(nèi)容錯誤21008BACKGROUND_IMAGE_LOSS背景圖片缺失21009BODY_MASK_LOSSbodymask缺失21010FACE_ANGLE_ERROR人臉角度錯誤21011SKIN_MASK_LOSSskinmask缺失21012BODY_INFO_LOSS骨骼點(diǎn)或者外輪廓點(diǎn)缺失21013RECT_OUT_IMAGE超過圖片范圍通用的錯誤代碼與信息HTTP返回碼返回碼錯誤信息說明200成功的請求成功的請求400錯誤的請求錯誤的請求，通常為照片不符合規(guī)范等401鑒權(quán)失敗鑒權(quán)失敗，出現(xiàn)此錯誤時，請檢查您的AKSK是否正確403鑒權(quán)失敗鑒權(quán)失敗，出現(xiàn)此錯誤時，請檢查您的應(yīng)用是否過期404請求的接口錯誤請求的接口地址錯誤，請檢查請求的接口地址是否正確424下載圖片失敗下載圖片失敗，請確認(rèn)您使用的圖片URL地址是否能正常下載433請求實(shí)體過長請求實(shí)體過長，請檢查您的圖片是否超過接口限制415算法內(nèi)部異常算法內(nèi)部異常，請稍后重試500請求異常請求內(nèi)部異常，請稍后重試502無響應(yīng)請求無響應(yīng)，請稍后重試503并發(fā)過高請求并發(fā)超過限制504請求異常請求內(nèi)部異常，請稍后重試599請求超時請求超時，請稍后重試網(wǎng)關(guān)網(wǎng)關(guān)相關(guān)錯誤碼，通常是鑒權(quán)錯誤ErrorCode錯誤信息說明90000GATEWAY_INVALID_PARAMETER錯誤的入?yún)?，入?yún)⒔壎ㄊ?0001GATEWAY_PARAMETER_ERROR錯誤的入?yún)⒅?，對入?yún)⒉僮饕鸬腻e誤90002GATEWAY_AUTHORIZED_ERROR鑒權(quán)出錯90003GATEWAY_AUTHORIZED_NOT_MATCH鑒權(quán)匹配錯誤90005GATEWAY_AUTHORIZED_NOT_ACCEPTABLE鑒權(quán)不可用90004GATEWAY_INVALID_FORMFILE錯誤的表單文件，表單文件提取失敗90006GATEWAY_FORMAT_HEADERS_ERROR格式化頭部異常90007GATEWAY_FORMAT_BODY_ERROR格式化body異常90008GATEWAY_FORMAT_PARAMS_ERROR格式化params異常90009GATEWAY_TIMEOUT請求超時90010GATEWAY_JSON_MARSHAL_ERRORJSON編碼錯誤90011GATEWAY_JSON_UNMARSHAL_ERRORJSON解碼錯誤90012GATEWAY_BASE64_ENCODE_ERRORBASE64編碼錯誤90013GATEWAY_BASE64_DECODE_ERRORBASE64解碼錯誤90014GATEWAY_NOT_FOUND查找不到數(shù)據(jù)90015GATEWAY_FOUND_ERROR數(shù)據(jù)查詢異常90016GATEWAY_PUSH_QUEUE_ERROR隊列推送異常90017GATEWAY_GET_BODY_ERRORbody讀取異常90020GATEWAY_REQUEST_FORWARD_ERROR請求算法的處理異常90021GATEWAY_FORWARD_RESPONSE_ERROR算法響應(yīng)處理異常90022GATEWAY_ALGORITHM_DISABLE算法不可用90023GATEWAY_QUEUE_RESPONSE_ERROR算法隊列響應(yīng)異常90024GATEWAY_QPS_LIMIT超過當(dāng)前限制qps90099GATEWAY_UNKNOWN_ERROR未知錯誤算法通用錯誤碼ErrorCode錯誤信息說明10000INVALID_PARAMETER錯誤的參數(shù)10002REQUEST_TIMEOUT請求超時10003IMAGE_DOWNLOAD_FAILED圖片下載失敗10004TASK_NOEXIST任務(wù)不存在10005SO_ERRORso庫錯誤10006CONTENT_ERROR內(nèi)容錯誤10007DECODE_IMAGE_ERROR圖片解碼錯誤10008ENCODE_IMAGE_ERROR圖片編碼錯誤10009PROCESS_IMAGE_ERROR圖片處理錯誤10010LENTP_ERRORLentp圖片解析錯誤10011SHARE_ERROR共享內(nèi)存錯誤10012IMAGE_LENGTH_ERROR圖片長度接收錯誤10013BASE64_DECODE_ERRORBase64解碼錯誤10014URLDECODE_ERRORUrlDecode解碼錯誤10015RESOURCE_ERRORGPU/顯存資源不足，服務(wù)臨時不可用10016SLICE_IMAGE_ERROR圖片分塊錯誤10017MERGE_IMAGE_ERROR圖片塊合并錯誤10018FPGA_PROCESS_ERRORFPGA處理錯誤10019FPGA_PROCESS_TIMEOUTFPGA處理超時10024UNKNOWN_ERROR未知錯誤算法特有錯誤碼匯總ErrorCode狀態(tài)代碼錯誤信息說明20001PROCESS_ERROR處理錯誤20003DETECT_NOT_FACE人臉缺失20004MORE_THAN_ONE_FACE人臉數(shù)大于120007MISSING_LANDMARK_ARGUMENTS未傳入人臉點(diǎn)20008UNSUITABLE_IMAGE照片不符合規(guī)范20009UNSUPPORT_TYPE不支持的type20010DETECT_NOT_FACE檢測不到第二張圖片的人臉20011UNSUITABLE_VERTICAL_IMAGE垂直高度不滿足20012UNSUITABLE_HORIZONTAL_IMAGE水平寬度不滿足20013RESOLUTION_TOO_LARGE_ERROR分辨率過大20014NOT_FOUND查找不到圖片20015PICTURE_OVERRUN_ERROR圖片超限20020DETECT_FACE_OUTOFIMAGE五官缺失20021DETECT_FACE_PITCHANGLE_BIG非正臉點(diǎn)頭俯仰角過大20022DETECT_FACE_YAWANGLE_BIG非正臉搖頭旋轉(zhuǎn)角過大20023DETECT_FACE_LOWAREA臉部占比小像素低20024MASK_NOT_ENOUGH檢測到人數(shù)不足20025INIT_FAIL初始化失敗20026NO_SUCH_MODE沒有此模式20027TOO_SMALL_AREA可貼圖區(qū)域過小20028NO_MATERIALS_TO_PASTE可貼素材數(shù)量為零20029TOO_SMALL_SIZE素材尺寸太小20030WRONG_DIRECT方向參數(shù)錯誤20031TOO_BIG_DENSITY密度太大20032NO_CATS_OR_DOGS沒有檢測到貓狗20033skythresholdtoolow沒有檢測到天空區(qū)域21001LOAD_MODEL_ERROR加載模型失敗21002HAIR_MASK_LOSS頭發(fā)mask缺失21003FACE_NUM_ERROR人臉個數(shù)錯誤21004AR_PARSE_FAULTar中plist解析錯誤21005AR_EEEOR_COUNTar人臉錯誤21006AR_FACE_OUTar超過人臉范圍21007JSON_ERRORjson內(nèi)容錯誤21008BACKGROUND_IMAGE_LOSS背景圖片缺失21009BODY_MASK_LOSSbodymask缺失21010FACE_ANGLE_ERROR人臉角度錯誤21011SKIN_MASK_LOSSskinmask缺失21012BODY_INFO_LOSS骨骼點(diǎn)或者外輪廓點(diǎn)缺失21013RECT_OUT_IMAGE超過圖片范圍21014DETECT_NO_BODYbodymask為空21015AGE_INFO_LOSS缺少年齡數(shù)據(jù)21016GENDER_INFO_LOSS缺少性別數(shù)據(jù)21017CSKETCH_TYPE_ERROR線稿type錯誤21018CSKETCH_STRING_ERROR線稿外部傳入字符串錯誤21019CSKETCH_INVALID_NICKNAME表示用戶昵稱中存在無效字符21020CSKETCH_NULL_INPUT_STRING表示用戶昵稱中存在無效字符服裝換色服裝換色描述版本圖片要求更新日志調(diào)用URL安全提示調(diào)用方法權(quán)限請求參數(shù)輸入值示例返回值說明成功返回值說明失敗返回值說明返回值示例請求成功返回示例請求失敗返回示例當(dāng)前API特有的錯誤代碼與信息通用的錯誤代碼與信息調(diào)用示例描述本接口用于云端處理給衣服換色的請求，具體效果請看以下文檔詳情。版本1.0圖片要求圖片格式：JPG，PNG更新日志調(diào)用URL正式環(huán)境：/v1/change_img_color?api_key=${APPKEY}&api_secret=${SECRETID}//注：${APPKEY}${SECRETID}表示在后臺申請的應(yīng)用密鑰對安全提示密鑰禁止對外直接開放調(diào)用,對外建議采用簽名的鑒權(quán)方式簽名鑒權(quán)方案調(diào)用方法POSTrequest的頭的類型應(yīng)包含：Content-Type:application/jsonGID相關(guān)：header中包含phone_gid:XXXUID相關(guān)：header中包含phone_uid:XXX權(quán)限使用前需提前申請APPKEY和SECRETID。請求參數(shù)是否必選參數(shù)名類型參數(shù)說明必選media_info_listList每個項包含一個多媒體信息（例如：圖片數(shù)據(jù)以及對應(yīng)信息）必選parameterObject處理需要的參數(shù)信息可選extraObject網(wǎng)關(guān)處理額外信息

media_info_list中單個元素的參數(shù)說明是否必選參數(shù)名類型參數(shù)說明必選media_dataString多媒體文件經(jīng)過base64編碼，url不經(jīng)過編碼可選media_extraObject包含對多媒體文件的描述，例如圖片中的人臉點(diǎn)，五官屬性等必選media_profilesObject多媒體文件的相關(guān)屬性信息描述

media_profiles中參數(shù)說明是否必選參數(shù)名類型參數(shù)說明可選media_data_typeString'jpg'，表示media_data是經(jīng)過base64壓縮過的圖片，默認(rèn)'jpg'

'url'，表示media_data是圖片url地址

parameter中參數(shù)說明是否必選參數(shù)名類型參數(shù)說明可選rsp_media_typeString“jpg”：融合結(jié)果圖像直接以base64編碼方式返回必選color_strString“#FFC0CB”：要換的衣服顏色必選cloth_categoryString要換的衣服類型，目前只能是"dress"、"up"、"down"三個選擇之一輸入值示例{"parameter":{"rsp_media_type":"jpg","color_str":"#FFC0CB","cloth_category":"dress"},"media_info_list":[{"media_data":"/9j/4AAQSkZJRgABAQAAAQABAAD...","media_extra":{},"media_profiles":{"media_data_type:"jpg"}}],"extra":{}}返回值說明成功返回值說明字段類型參數(shù)說明media_info_listList每個項包含一個多媒體信息（例如：圖片數(shù)據(jù)以及對應(yīng)信息），同上parameterObject返回信息類型標(biāo)識

media_info_list中單個元素的字段說明字段類型參數(shù)說明media_dataString經(jīng)過base64編碼的多媒體文件數(shù)據(jù)media_profilesObject多媒體文件的相關(guān)屬性信息描述

media_data中字段說明字段類型參數(shù)說明outimg1String換色后的圖片,'jpg'，表示media_data是經(jīng)過base64壓縮過的圖片outimg2String衣服分割圖片，'jpg'，表示media_data是經(jīng)過base64壓縮過的圖片outimg3String衣服原圖，'jpg'，表示media_data是經(jīng)過base64壓縮過的圖片

parameter中字段說明字段類型參數(shù)說明rsp_media_typeString'jpg'，表示media_data是經(jīng)過base64壓縮過的圖片

media_profiles中字段說明字段類型參數(shù)說明media_data_typeString'jpg'，表示media_data是經(jīng)過base64壓縮過的圖片失敗返回值說明字段類型說明ErrorCodeInt錯誤代碼ErrorMsgString錯誤信息DataString具體信息返回值示例返回值示例請求成功返回示例ResponseStatus：200content-type為application/json;charset=utf-8{"parameter":{"rsp_media_type":"jpg",}"media_info_list":[{"media_data":outimg1,"media_profiles":{"media_data_type":"jpg"}},{"media_data":outimg2,"media_profiles":{"media_data_type":"jpg"}},{"media_data":outimg3,"media_profiles":{"media_data_type":"jpg"}}]}請求失敗返回示例ResponseStatus：400content-type為application/json;charset=utf-8{"ErrorCode":20003,"ErrorMsg":"detectnoface","Data":null}當(dāng)前API特有的錯誤代碼與信息ErrorCode狀態(tài)代碼錯誤信息說明20001PROCESS_ERROR處理錯誤20003DETECT_NOT_FACE人臉缺失20004MORE_THAN_ONE_FACE人臉數(shù)大于120007MISSING_LANDMARK_ARGUMENTS未傳入人臉點(diǎn)20008UNSUITABLE_IMAGE照片不符合規(guī)范20009UNSUPPORT_TYPE不支持的type20010DETECT_NOT_FACE檢測不到第二張圖片的人臉20011UNSUITABLE_VERTICAL_IMAGE垂直高度不滿足20012UNSUITABLE_HORIZONTAL_IMAGE水平寬度不滿足20013RESOLUTION_TOO_LARGE_ERROR分辨率過大20014NOT_FOUND查找不到圖片20015PICTURE_OVERRUN_ERROR圖片超限20020DETECT_FACE_OUTOFIMAGE五官缺失20021DETECT_FACE_PITCHANGLE_BIG非正臉點(diǎn)頭俯仰角過大20022DETECT_FACE_YAWANGLE_BIG非正臉搖頭旋轉(zhuǎn)角過大20023DETECT_FACE_LOWAREA臉部占比小像素低21001LOAD_MODEL_ERROR加載模型失敗21002HAIR_MASK_LOSS頭發(fā)mask缺失21003FACE_NUM_ERROR人臉個數(shù)錯誤21004AR_PARSE_FAULTar中plist解析錯誤21005AR_EEEOR_COUNTar人臉錯誤21006AR_FACE_OUTar超過人臉范圍21007JSON_ERRORjson內(nèi)容錯誤21008BACKGROUND_IMAGE_LOSS背景圖片缺失21009BODY_MASK_LOSSbodymask缺失21010FACE_ANGLE_ERROR人臉角度錯誤21011SKIN_MASK_LOSSskinmask缺失21012BODY_INFO_LOSS骨骼點(diǎn)或者外輪廓點(diǎn)缺失21013RECT_OUT_IMAGE超過圖片范圍通用的錯誤代碼與信息詳見

API錯誤碼調(diào)用示例curl-vXPOST"/v1/change_im