Description

This API is used for ID Photo - Query Unwatermarked Images requests. For specific effects, please refer to the details in the following documentation.

Version

1.0

Image Requirements

Image formats: JPG, PNG

Changelog

Request URL

Production environment: https://openapi.meitu.com/idphoto/business/v1/query/unwatermarked_images

Request Method

POST

The request header type should include: Content-Type:application/json

Permission

Open Platform API Signature

Credits cannot be used to pay for API calls. Please visit the MV console to activate this API and purchase or manage resource packages.

Request Parameters

Parameter Name	Type	Maximum Length	Required	Remarks
mt_generate_id	string	200	Yes	Meitu generation ID returned by the watermarked image request

Request Example

{
     "mt_generate_id":"36936"
}

Return Value Description

Successful Return Value Description

Field Name	Type	Example Value	Description
code	integer	100000	Response status code
msg	string	Operation successful	Response status code description
data	object		Response data
data.sd_photo	string		Standard-definition unwatermarked image or basic unwatermarked image (the unwatermarked image corresponding to the single image returned by the special effects API)
data.hd_photo	string		High-definition unwatermarked image
data.typesetting_photo	string		Typesetting unwatermarked image

Failed Return Value Description

Field	Type	Description
data	String	Returned content
message	String	Error message
code	Int	Error code

Return Value Example

Successful Request Return Example

Response Status: 200

content-type is application/json; charset=utf-8

{
    "code": 100000,
    "msg": "Operation successful",
    "data": {
        "sd_photo": "http://o%3D",
        "hd_photo": "http://%3D",
        "typesetting_photo": "http://1234"
    },
    "log_id": "sPR1rSoaU7bqzuooGjWTzDunw6IsB58k"
}

Return Status Codes

Status Code	Description
100000	Success
100001	Parameter error

Common Error Codes and Information

For details, see API Error Codes

Note: If this API returns code 555, it indicates an image generation error, but no fee will be charged.