Get started

Set up your first application, choose an integration path, and run your first verification.

Prerequisites

Book a demo to get access. After onboarding, sign in to the dashboard and create an application for your project.

Create your first application

An application scopes jobs, API keys, and team access. Organization admins can create one from the empty dashboard (Create application) or from the application switcher in the sidebar (Create application).Note the application's applicationId — you need it for API calls and client SDK setup.

Generate an API key (server integrations)

For server-side or direct REST usage, open your application, go to API Keys in the sidebar, and generate a key. Store it securely and send it as Authorization: Bearer <api_key>. See Authentication for details.

Choose an integration path

Pick the approach that matches where uploads run in your product:

API workflow (REST)

The fastest way to verify a single file is one call to Assess (POST /v1/assess): upload the file as multipart/form-data. The call waits for analysis by default and responds 200 with the verdict when it finishes inside the wait window; otherwise it returns 202 with a processing status and you poll the job until it completes.To read a result later, call Get job (GET /v1/jobs/:jobId) and poll until the job's status leaves processing. It ends as completed (with a verdict) or error. Pass ?wait=true to long-poll instead of tight-looping. Use List jobs (GET /v1/jobs) to browse previous submissions.

Example request and response

Send the file with your API key. When analysis finishes inside the wait window, POST /v1/assess responds 200 with the completed job and its verdict:

curl -X POST "https://api.pixelsystems.com/v1/assess" \
  -H "Authorization: Bearer {api_key}" \
  -H "Idempotency-Key: case-123-front-photo" \
  -F "file=@photo.jpg;type=image/jpeg" \
  -F 'metadata={"customer_case_id":"case-123"}'

{
  "jobId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "verdict": {
    "assessment": "ai_generated",
    "confidence": "high",
    "display": {
      "label": "AI Generated",
      "title": "AI Generated",
      "description": "AI Generated image detected"
    },
    "dimensions": [
      {
        "key": "ai_detection",
        "label": "AI generation",
        "assessment": "likely_ai",
        "score": 0.82,
        "confidence": "high"
      }
    ]
  },
  "metadata": { "customer_case_id": "case-123" },
  "createdAt": "2024-06-01T12:00:00Z",
  "completedAt": "2024-06-01T12:00:14Z"
}

The verdict carries the assessment, a confidence level, and a per-dimension breakdown. Field-by-field documentation lives in Assess.

API reference

Full endpoint documentation lives under API Reference in the sidebar, starting with Authentication and Assess. See also Concepts for how jobs, files, and sessions relate.