API Documentation

Base URL

Authentication

Include your API key in the x-api-key header. Get your key from the Dashboard.

# All requests require x-api-key header
curl -H "x-api-key: ce_live_your_key_here" \
  https://api.cutengine.dev/health

Endpoints

Quick Start: Render a Video

1. Submit render

curl -X POST https://api.cutengine.dev/edit/v1/render \
  -H "x-api-key: ce_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "timeline": {
      "background": "#000000",
      "tracks": [{
        "clips": [{
          "asset": {
            "type": "image",
            "src": "https://example.com/photo.jpg"
          },
          "start": 0,
          "length": 5,
          "effect": "zoomIn",
          "transition": { "in": "fade" }
        }]
      }]
    },
    "output": {
      "format": "mp4",
      "resolution": "hd",
      "aspectRatio": "16:9"
    }
  }'

# Response: { "success": true, "response": { "id": "render_abc123", "status": "queued" } }

2. Poll for status

curl https://api.cutengine.dev/edit/v1/render/render_abc123 \
  -H "x-api-key: ce_live_your_key_here"

# When done: { "response": { "status": "done", "url": "https://..." } }