Overview

Translucid provides a REST API for provisioning DRM-encrypted virtual machines with real-time browser streaming. Each session runs an isolated VM with a full browser environment, protected by screen capture prevention, forensic watermarking, and configurable security controls.

Authentication

All API requests require authentication via an API key passed in the Authorization header.

Authorization: Bearer sk_live_your_api_key_here

API keys are generated from the Account page. Keys starting with sk_live_ are production keys. Keep them secret — never expose in client-side code.

Base URL

All endpoints are relative to the base URL. For example, creating a session is POST /sessions/v1.

Create Session

Provisions a new DRM-encrypted VM session. The VM boots with the specified environment, opens the startup URL(s), and returns a player URL for real-time streaming.

Request Body

Example Request

curl -X POST https://api.translucid.cloud/sessions/v1 \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "startupUrl": "https://example.com",
    "environment": { "environmentId": "intel-chromium-001" },
    "system": { "machineProfile": "vcpu4-ram16-standard" },
    "session": { "durationMinutes": 60 }
  }'

Response

{
  "session": {
    "id": "a5be3cf2-...",
    "status": "provisioning",
    "playerUrl": "https://api.translucid.cloud/player/a5be3cf2-...",
    "expiresAt": "2025-02-18T12:00:00Z"
  },
  "startup_page_url": "https://api.translucid.cloud/s/a5be3cf2-..."
}

Get Session

Retrieve details of an existing session by ID.

{ "session": { "id": "...", "status": "ready", "publicIp": "3.16.10.34", ... } }

List Sessions

List all sessions for your organization. Returns active, ended, and terminated sessions.

Terminate Session

Immediately terminates the VM and ends the session. This action cannot be undone.

Runtime Control

Update security settings and input controls on a running session. Changes are pushed to connected clients instantly via WebSocket.

Push URLs

Push new URLs to a running session's startup page. The URLs appear live with a notification sound.

{
  "pushUrl": [
    { "url": "https://docs.example.com", "title": "Documentation" },
    { "url": "https://figma.com/file/..." }
  ]
}

Environments

Each environment is a pre-built VM template with a specific OS, browser, and DRM configuration.

Machine Profiles

Choose a compute tier based on your workload requirements.

Pricing

Sessions are billed per minute of active VM time. Pricing varies by machine profile.

Prices are estimates and may vary. Contact sales for volume discounts.

Error Codes

{ "error": "Description of what went wrong", "code": "error_code" }