v1.2Endpoint

Secure Video Processing

The core endpoint for injecting imperceptible cryptographic watermarks into video files using the Split-Stream Method.

POST/v1/secure-video

Input Parameters

video_urlstring

The publicly accessible URL of the source video. Must be a direct link to a supported format (MP4, MOV).

Required

creator_idstring

Unique identifier for the content owner. This ID is cryptographically bound to the video payload.

Required

Example Request

curl -X POST https://api.lexpixel.pro/v1/secure-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "video_url": "https://storage.ex.com/v/123.mp4",
  "creator_id": "usr_98765xyz"
}'

Response

Processing is asynchronous. The API returns a job_id which you must poll to retrieve the final asset.

200 OK

{
  "status": "processing",
  "id": "7a2b-3c4d-5e6f",
  "status_url": "/v1/jobs/7a2b-3c4d-5e6f",
  "message": "Video processing initiated. EU AI Act compliance manifest being injected."
}

GET/v1/jobs/[id]

Poll Job Status

Retrieve the current status of a processing job. Once status is completed, the protected_url will contain the temporary link to your watermarked asset (valid for 60 minutes).

Statuses

pending— Queued for processing
processing— GPU tensors applying VideoSeal
completed— Success, URL available

Completed Response

{
  "id": "7a2b-3c4d-5e6f",
  "status": "completed",
  "protected_url": "https://cdn.lexpixel.pro/temp/protected_asset.mp4",
  "created_at": "2026-04-17T14:28:00Z",
  "completed_at": "2026-04-17T14:30:00Z"
}

POSTYour Webhook URL

Webhook Notifications

LexPixel can notify your system immediately when a job is completed or failed. Configure your Webhook URL in settings to receive these asynchronous events.

Security & Verification

All requests include a X-LexPixel-Signature header. Use your Webhook Secretto verify the authenticity of the request.

shield

Algorithm: HMAC-SHA256
Data: Raw JSON Payload string

Signature Verification (Node.js)

const crypto = require('crypto');

function verify(payload, sig, secret) {
  const hmac = crypto.createHmac('sha256', secret);
  const digest = hmac.update(payload).digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(sig), 
    Buffer.from(digest)
  );
}

// In your Express route:
const signature = req.headers['x-lexpixel-signature'];
const isValid = verify(req.rawBody, signature, SECRET);

info

Sandbox Tier Policy

The Sandbox Tier is for development and testing. While all regulatory compliance (C2PA) is included, sandbox outputs will contain a visible LexPixel watermark in the bottom-right corner.

Upgrade to Pro or Agency tiers to remove visible branding and enable 4K priority processing.

waves

The Split-Stream Method

Traditional watermarking requires decoding and re-encoding the entire video file, introducing latency and potential quality degradation. LexPixel utilizes a proprietary Split-Stream Method.

bolt

Zero-Degradation

We blend cryptographic markers directly into the original video frames, ensuring the highest visual fidelity without lossy re-encoding loops.

timer

Cost-Effective Latency

By generating masks at 480p and upscaling them to 4K, we cap tensor math costs while maintaining near-instant protection for high-res assets.