Skip to content
Skip to content

Documentation

Everything you need to start with Sphot and produce your first automated Reel.

Getting Started
1

Connect Instagram

Go to Settings → Connections → Instagram and click “Connect account”. Authorise Sphot in the Instagram OAuth dialog. You will be returned to the dashboard with your account linked.

2

Upload footage

Connect your Google Drive folder under Settings → Connections → Google Drive, or upload clips directly from the Assets tab. Sphot accepts MP4, MOV, and WebM files up to 2 GB per clip.

3

Create your first Reel

Click New Reel from the sidebar. The Footage Wizard will guide you through five stages: Concept → Footage → Confirm → Processing → Publish. Your first reel is typically ready in 3–8 minutes.

Creating Reels

Footage Wizard walkthrough

Concept: Describe your video idea or pick a topic from your content calendar. Sphot’s AI generates a script, hook, and caption draft.

Footage: Browse your Drive or uploaded assets. Drag clips into the storyboard, or let Sphot auto-select based on your script.

Confirm: Preview the storyboard, edit the script or hook, and set platform targets (Instagram, YouTube, TikTok).

Processing: Sphot renders the reel through its 19-stage Production Run pipeline — music sync, colour grading, captions, quality check.

Publish: Approve and publish immediately, or schedule for your optimal posting window. The final video and caption are pushed directly to the platform.

Automation

Schedules: Under Reels → Schedule, create a posting cadence (e.g. 3 reels/week). Sphot automatically queues Production Runs to fill your schedule, choosing ideas from your approved content plan.

Production Runs: Each run is a fully automated pipeline that takes an idea all the way to a published post. Monitor progress in real time under Reels → Production Runs.

Content Calendar: The calendar view shows past and upcoming posts. Drag to reschedule, or click any slot to create a new reel for that date.

Knowledge Base

The Knowledge Base stores brand context — your niche, tone of voice, audience notes, FAQs, and reference documents. Sphot’s AI reads this context when generating scripts and captions.

Sync from Google Drive: Connect a Drive folder and Sphot will index its documents automatically. New or edited files are re-indexed within 15 minutes.

Semantic search: Use the search bar inside the Knowledge Base to find relevant excerpts — the same search that powers in-house AI script suggestions.

Brand Kit

Found under Settings → Brand. Upload your logo (PNG/SVG, transparent background recommended), define your brand colours, and set your preferred font pairing.

Brand Kit assets are applied automatically to lower-thirds, title cards, and end screens during the colour-grade and motion-graphics stages of every Production Run.

Analytics

Instagram metrics are synced every 6 hours: plays, reach, likes, shares, saves, and engagement rate. Requires the analytics scope to be granted during OAuth.

Top-performing specs shows which durations, aspect ratios, hook styles, and posting times correlate with the highest engagement on your account.

AI Strategy Advisor: Click “Ask AI” on any analytics card to get a plain-language explanation and a suggested action.

Platform Connections

Instagram

Settings → Connections → Instagram. Requires a Business or Creator account linked to a Facebook Page. Grant the instagram_content_publish and instagram_manage_insights scopes for full functionality.

YouTube

Settings → Connections → YouTube. Authorise via Google OAuth. Sphot requests theyoutube.upload scope to post Shorts directly.

Google Drive

Settings → Connections → Google Drive. Select the folder(s) you want Sphot to watch for new footage and Knowledge Base documents.

API & Webhooks

API keys: Settings → API Keys → Generate. Keys are prefixed sk_ and shown only once. Pass them as a Bearer token in the Authorization header.

Webhook endpoints: Settings → Webhooks → Add endpoint. Sphot sends a signed POST request to your URL on each event. Verify the X-Sphot-Signature header using HMAC-SHA256 with your webhook secret.

Event types

  • reel.createdA new reel has been queued for production
  • reel.approvedA reel was manually approved
  • reel.publishedA reel was successfully published to a platform
  • reel.failedA production run failed quality checks
  • run.startedA new Production Run has begun
  • run.completedA Production Run finished all 19 stages

Example webhook payload

{
  "event": "reel.published",
  "timestamp": "2026-06-18T09:41:00Z",
  "data": {
    "reel_id": "abc123",
    "platform": "instagram",
    "ig_permalink": "https://www.instagram.com/reel/Cxyz/"
  }
}
FAQ

What video formats does Sphot accept?

MP4 (H.264/H.265), MOV, and WebM. Maximum file size is 2 GB per clip. Audio tracks must be stereo or mono AAC/MP3.

How long does a Production Run take?

Most runs complete in 3–10 minutes. Complex reels with heavy b-roll, colour grading, and voiceover may take up to 20 minutes.

How many reels can I post per day?

Instagram enforces a rate limit of roughly 25 posts per 24 hours per account. Sphot respects this automatically. For higher volumes, connect multiple Instagram accounts.

Can I edit the AI-generated script before it renders?

Yes. After the Concept stage you can fully edit the script, hook, and caption in the Confirm step before triggering Processing.

What happens if a reel fails quality checks?

Sphot retries QC up to 3 times with automatic corrections. If all attempts fail, the run is marked failed and you receive a notification with the failure reason.

Does Sphot add watermarks?

No watermarks are added. Your Brand Kit lower-third is the only overlay, and it is optional.

How do I delete my data?

Go to Settings → Account → Delete Account. This permanently removes all reels, assets, analytics, and API keys within 30 days.

Is there a free tier?

Yes. The free tier allows up to 5 production runs per month with standard quality. Upgrade to a paid plan for unlimited runs, priority rendering, and advanced analytics.

When does my monthly reel quota reset?

Your quota resets on your billing date each month — the same day you first subscribed. Unused quota does not roll over. Check your next reset date in Settings → Billing.

Can I connect multiple Instagram accounts?

Yes. The number of accounts depends on your plan. Go to Settings → Connections → Add Instagram Account. Each account requires its own OAuth authorisation. When creating a reel, choose which account to publish to in the wizard.

How does the AI choose which footage to use?

Sphot One scores each clip for visual quality, motion, clarity, and relevance to your concept. It selects the highest-scoring moments and trims clips to 1.5–8 seconds. A detailed concept description improves selection accuracy.

Why was my reel rejected in the approval step?

The approval step is where you review the produced reel before publishing. Click "Request Revision" to describe what to change — tone, clips, music, captions. Revision runs consume quota just like the original.

How do I cancel my subscription?

Go to Settings → Billing → Cancel Subscription. Access continues until the end of the current billing period. Your reels and data remain stored for 30 days before permanent deletion. You can reactivate within that window.

Can I export my published reels?

Yes. On the reel detail page, click Download to save the MP4. For bulk export, go to Settings → Data → Export. Exports are H.264 MP4 at 1080×1920 and available for 30 days after production.

Built on top of
Instagram API
Google Drive
After Effects
ffmpeg
Gemini AI