AutoEditor — Agent Interface

POST https://api.autoeditor.app/agent/sign-in

Sign in on behalf of the user. Returns a Supabase access token (JWT) and the user's API key.

Body:

{
  "email": "user@example.com",
  "password": "their-password"
}

Returns: { accessToken, apiKey, userId }

Use the accessToken as Authorization: Bearer <accessToken> for all subsequent calls.

POST https://api.autoeditor.app/agent/upload auth required

Create a new editing job from a video URL. The video will be downloaded and processed automatically.

Headers: Authorization: Bearer <accessToken>

Body:

{
  "videoUrl": "https://example.com/video.mp4",
  "mode": "long",
  "aggression": "high",
  "filename": "optional-filename.mp4"
}

mode options: long (long-form), vertical (shorts/reels), horizontal (standard)

aggression options: low, medium, high, viral

Returns: { jobId, status, estimatedDuration }

POST https://api.autoeditor.app/agent/choose-mode

Get a recommendation for the best editing mode based on video properties. No auth required.

Body:

{
  "durationSeconds": 813,
  "hasSpeech": true,
  "contentType": "talking-head",
  "description": "A delivery driver sharing tips about making money"
}

contentType options: talking-head, gaming, podcast, vlog, tutorial, reaction, interview, unknown

Returns: { recommendedMode, recommendedAggression, reasoning }

POST https://api.autoeditor.app/agent/subscribe auth required

Create a Stripe checkout session for a subscription plan. Returns a URL the user must visit to complete payment.

Headers: Authorization: Bearer <accessToken>

Body:

{
  "plan": "creator",
  "billing": "monthly"
}

plan options: basic, starter, creator, studio, founder

billing options: weekly, monthly, annual

Returns: { checkoutUrl }

GET https://api.autoeditor.app/agent/job/:jobId auth required

Check the status of an editing job.

Returns: { status, progress, outputUrl, durationSeconds, viralScore }

GET https://api.autoeditor.app/agent/plans

List all available subscription plans with pricing. No auth required.