Skip to main content

Endpoint

Request Headers

Query Parameters

Response Attributes

analysis_result (when ready)

Extra keys inside analysis_result may exist for forward compatibility.

Example

Request

Response (analysis completed)

Analysis Status

Important Notes

  • Poll until status is 3 or 4 before creating a head swap task (unless your product flow allows otherwise).
  • Wrong _id or no team access may yield not-found style errors (e.g. 1014 / Resource not found depending on environment).
  • mappings[].img_url at task creation is your reference face image; it does not have to match the analysis preview URL, but each obj_id must match an entry from media.