Create Analysis Task
Overseas
https://gapi.evelabinsight.com
Overseas
https://gapi.evelabinsight.com
POST
https://gapi.evelabinsight.com
task_id; use GET /skin_api/analyze/result?task_id=... to query the task status and result. Each task can select only one api_code + algorithm_variant combination.Request Fields
| Field | Required | Description |
|---|---|---|
api_code | Yes | Capability code. See the supported combinations below. |
algorithm_variant | Yes | Algorithm variant. It must form one of the supported combinations below with api_code. |
resources | Conditional | Standard image resource object. Every value must be a directly downloadable HTTP/HTTPS URL; required keys and image count depend on the capability combination. |
dimension_codes | No | Supported only by eve_v. Omit it or pass [] to use all dimensions available to the current order. |
output_options | No | Currently used only by online_skin + all_race_v2. If omitted or set to {}, mask_format defaults to annotation_image. |
metadata | No | Caller-provided notes. They do not affect analysis and are not returned in the result. Do not include passwords, tokens, or personal data. |
Supported Capability Combinations
| api_code | algorithm_variant | Image Requirements | dimension_codes | Quota Rule |
|---|---|---|---|---|
eve_v | standard | Front, left, and right white-light images are required; submit every optional light source as a complete three-view set. | Supported | One quota unit is consumed only when the task succeeds. |
eve_v | partition | Same as standard. | Supported | One quota unit is consumed only when the task succeeds. |
online_skin | standard | front_image only. | Not supported | One quota unit is consumed only when the task succeeds. |
online_skin | all_race | front_image only. | Not supported | One quota unit is consumed only when the task succeeds. |
online_skin | all_race_v2 | Either front_image only, or a complete front/left/right set. | Not supported | One quota unit is consumed only when the task succeeds. |
face_pose_correction | standard | front_image only. | Not supported | Requires a valid Skin API order; no quota is consumed. |
face_pose_correction | all_race | front_image only. | Not supported | Requires a valid Skin API order; no quota is consumed. |
face_pose_correction | all_race_v2 | Either front_image only, or a complete front/left/right set. | Not supported | Requires a valid Skin API order; no quota is consumed. |
facial_analysis | standard | front_image only. | Not supported | Requires a valid Skin API order; no quota is consumed. |
facial_analysis | all_race | front_image only. | Not supported | Requires a valid Skin API order; no quota is consumed. |
Image Resource Rules
white_front_image, white_left_image, and white_right_image must all be provided for Eve V.white_glow, cross_polar, parallel_polar, and uv are optional Eve V light sources. Once a light source is provided, its front, left, and right images must all be provided.parallel_polar or uv for Eve V also requires a complete cross_polar set.front_image. Three-view capabilities accept either one front image or a complete front/left/right set; two-image combinations are invalid.output_options
mask_format values are:annotation_image: returns annotation image URLs grouped by detected dimension. This is the default for online_skin + all_race_v2.annotation_json: returns annotation JSON file URLs.output_options; omit it or pass {}.Compatibility Fields
pic_url maps to resources.front_image.json maps to resources and may be a resource object or a JSON object string.custom maps to metadata.detect_mask_type=1 maps to output_options.mask_format=annotation_image.detect_mask_type=2 maps to output_options.mask_format=annotation_json.detect_face_type=1|2 validates image count consistency only; it does not determine image count.paralle_polar_* are treated as parallel_polar_*; sensitiveness is treated as sensitivity.Response Handling
meta.code. A value of 0 means the task was created successfully, and response then contains only task_id. On failure, response is {}. Include meta.req_id when requesting support.Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://gapi.evelabinsight.com/skin_api/analyze/task' \
--header 'Access-Token: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"api_code": "eve_v",
"algorithm_variant": "standard",
"resources": {
"white_front_image": "https://example.com/input/white_front.jpg",
"white_left_image": "https://example.com/input/white_left.jpg",
"white_right_image": "https://example.com/input/white_right.jpg"
},
"output_options": {},
"metadata": {
"purpose": "client_request_reference"
}
}'Response Response Example
Task Created
task_id to poll its status and result.{
"meta": {
"code": 0,
"msg": "",
"error": "",
"req_id": "4826bbfa2ab1db905e6ac2909682746a",
"request_uri": "/skin_api/analyze/task"
},
"response": {
"task_id": "1776411212089374452"
}
}