Jobs

Identify an uploaded image (free)

Creates the job and runs the free identify step. Waits up to 5 seconds. If identify is slower, responds 202 with the job id; poll GET /jobs/{id}. A refused image returns status REFUSED with refusalReason. Send an Idempotency-Key header to make retries safe.

post/identify

Request

  • Base URL: https://demarker.io/api/v1
  • URL: https://demarker.io/api/v1/identify
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Request body

uploadKeystring required

Response

OK

idstring
status'UPLOADED' | 'IDENTIFYING' | 'IDENTIFIED' | 'HELD' | 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'REFUSED' | 'EXPIRED'
widthinteger
heightinteger
megapixelsnumber
hasInvisibleTargetboolean nullable
reportobject nullable

Engine provenance report, schema_version 1.

cmiFieldsunknown
balanceinteger
refusalReason'NSFW' | 'THIRD_PARTY_OVERLAY' | 'null' nullable
creditsChargedinteger
errorCodestring nullable
createdAtstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.