Skip to main content
POST
Generate Skin Analysis
Creates a skin analysis prediction request using the provided appId. Use the returned IDs to retrieve analysis results and reports.

Parameters

appIdstring
ID of the Skin Analysis app configuration created via POST Create App. Determines algorithm/report settings used for analysis.

Request body

input.imagestring
Face image file used for skin analysis. Upload as multipart/form-data (JPG/PNG); use a clear, front-facing, well-lit image for best results.

Response Body

inputobject
Echo of the submitted input data. Typically contains a reference URL to the uploaded image.
statusstring
Current state of the prediction job (e.g., ACCEPTED, PROCESSING, SUCCESS, FAILED). Poll the result endpoint until SUCCESS.
urlsobject
Object containing endpoint URLs related to this prediction job.
orgIdinteger
Identifier of the organization under which this prediction was created.
retentionstring
Duration for which prediction data and generated outputs will be retained.
createdAtstring
Timestamp indicating when the prediction job was created.
_idstring
Unique identifier of this prediction job. Use this value as predictionId when calling GET Skin Analysis Result.
subjectIdstring
Identifier that groups multiple scans belonging to the same subject (if applicable).
scanIdstring
Identifier of this specific scan instance. Required when retrieving results or generating a PDF report.
POST/sa-predictions/apps/{appId}/plugins/skinAnalysisInt/generate
curl -X POST "https://api.pixelbin.io/service/platform/misc/v1.0/sa-predictions/apps/{appId}/plugins/skinAnalysisInt/generate" \
-H "Authorization: Bearer {apitoken}" \
-F "input.image=@<path/to/file>"
Response
201
No example available.