Clips

Upload a podcast, interview, or webinar — Clips AI finds the best moments, crops to speaker, adds captions, and renders vertical/horizontal/square clips ready to publish across every platform.

Pipeline

Upload or import

Upload via multipart (large files) or paste a public URL. Autoposting downloads, normalizes, and extracts duration metadata.

AI detection

Audio is transcribed with word-level timestamps. AI scores segments for virality, hook strength, and retention. Face detection builds per-speaker crop keyframes.

Review candidates

AI-ranked clip candidates appear with scores for hook, retention, clarity, and visual. Select a candidate and choose a layout.

Render

Dispatch a render job. Track progress via GET /clips/:id. Credits are deducted only on successful completion.

Publish

Download the rendered clip or create a post draft pre-filled with the video for direct platform publishing.

Import via URL

curl -X POST https://app.autoposting.ai/api-proxy/clips/import-url \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "brandSlug": "brand_slug",
    "url": "https://example.com/episode-42.mp4",
    "title": "Episode 42"
  }'

Poll GET /clips/:id for processing status — the status field moves from processing to ready when candidates are generated.

Layouts

Layout	Best For
Focus	Single or dominant speaker — dynamic reframe
Split	Two-person conversations — speakers stacked top/bottom
Split + Caption Bar	Heavy dialogue — dedicated caption bar below split
Cinema	B-roll, demos, wide shots — full source frame
Auto	Let AI pick based on face count and scene analysis

Split layout requires at least 5 qualifying two-face frames spanning more than 3 seconds. If splitEligible: false, Split options are disabled and render falls back to Focus.

Submit a Render

curl -X POST https://app.autoposting.ai/api-proxy/clips/:clipId/render \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "candidateId": "candidate_id",
    "layout": "speaker-focus",
    "aspectRatio": "9:16",
    "captionPresetId": "bold-white"
  }'

const res = await fetch(`https://app.autoposting.ai/api-proxy/clips/${clipId}/render`, {
  method: "POST",
  headers: {
    Authorization: "Bearer sk_your_api_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    candidateId: "candidate_id",
    layout: "speaker-focus",
    aspectRatio: "9:16",
    captionPresetId: "bold-white",
  }),
});
const { data } = await res.json();
// data.jobId — track via GET /clips/:clipId

Output Formats

Composition	Resolution	Platforms
`clip-vertical`	1080×1920	TikTok, Instagram Reels, YouTube Shorts
`clip-horizontal`	1920×1080	YouTube, LinkedIn
`clip-square`	1080×1080	Instagram feed, LinkedIn square

Credit Costs

Operation	Credits
Render (per clip)	Based on duration and resolution
Failed render	0 — credits are never deducted on failure

Set clipTemplateDefaults on your brand to pre-configure caption presets and aspect ratios, saving configuration time when generating many clips.

Status Reference

Clip Status	Description
`uploading`	Multipart upload in progress
`processing`	Transcription, AI detection, face tracking running
`ready`	Candidates generated and available for review
`failed`	Processing pipeline failed

Candidate Status	Description
`generated`	AI candidate, not yet rendered
`rendering`	Render job dispatched
`completed`	Render finished — download URL available
`failed`	Render failed — no credits consumed

Posts

Publish rendered clips as scheduled posts across platforms.

Brands

Set default clip templates and aspect ratios per brand.

Carousels

Turn topics into multi-slide carousels instead of video clips.

API Reference

Upload, render, and download endpoint reference.

Getting Started

Core Concepts

Pipeline

Import via URL

Layouts

Submit a Render

Output Formats

Credit Costs

Status Reference

Posts

Brands

Carousels

API Reference

​Pipeline

​Import via URL

​Layouts

​Submit a Render

​Output Formats

​Credit Costs

​Status Reference

Posts

Brands

Carousels

API Reference

Pipeline

Import via URL

Layouts

Submit a Render

Output Formats

Credit Costs

Status Reference