API Documentation

Automate millions of assets using the exact deterministic logic defined in your Pipeline Studio. Engineered for high-throughput headless environments where creative variance is forbidden.

Execution Principles

Pipeline Alignment

API calls execute JSON schemas exported directly from Studio. Ensures zero logic drift between creative and dev teams.

Audit-By-Design

Every standardized asset returns a unique compliance audit object ready for marketplace API ingestion.

Immutable Versions

Standardization rules are version-locked. Calling v1.0.0 today yields bit-identical results in 2030.

Authentication

Access requires a Bearer Token provided in the request header.

Authorization: Bearer AL_LIVE_7f29...a1b2

Standardization Request

Rate Limit: 500 RPM

POST/v1/standardize/batch

Submits a batch of images for processing. Requires a preset_id created via the Studio UI. The request returns an execution_id for asynchronous tracking.

Request Body

{
  "preset_id": "studio.ecommerce_clean.v1",
  "version": "latest",
  "assets": [
    {
      "external_id": "SKU_9921",
      "url": "https://s3.env.com/raw/9921.jpg"
    }
  ],
  "options": {
    "output_format": "webp",
    "delivery_webhook": "https://api.yourdomain.com/hooks"
  }
}

Typical Response

HTTP 202 Accepted

{
  "execution_id": "exec_88ac2109",
  "status": "queued",
  "estimated_completion": "2026-01-27T12:55:00Z",
  "meta": {
    "active_nodes": ["US-EAST-1"],
    "total_assets": 1
  }
}

Dev Note: For real-time monitoring of high-volume batches, subscribe to the asset.standardized websocket stream to update downstream databases as each individual image completes.

Compliance Metadata

The engine performs an automated audit on the final pixels during the rendering phase. This metadata payload is essential for marketplace health score validation.

background_purityBoolean

Checks for RGB(255,255,255) consistency across non-subject pixels.

aspect_ratio_complianceFloat

Numerical deviation from the target marketplace aspect ratio.

subject_densityPercentage

Subject surface area relative to the canvas (0.0 - 1.0).

// Webhook Payload Fragment

"compliance": {
  "status": "PASS",
  "platform": "amazon_main",
  "rules_checked": 14,
  "violations": []
}