API 문서

Base URL

인증

모든 요청에 x-api-key 헤더를 포함해야 합니다. API 키는 대시보드에서 발급받을 수 있습니다.

# 모든 요청에 x-api-key 헤더 필요
curl -H "x-api-key: ce_live_your_key_here" \
  https://api.cutengine.dev/health

엔드포인트

빠른 시작: 비디오 렌더링

1. 렌더 요청

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"
    }
  }'

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

2. 상태 조회

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

# 완료 시: { "response": { "status": "done", "url": "https://..." } }