Submagic

Submagic

Submagic generates AI captions, styled subtitles, magic clips, and can publish finished videos to social platforms. Processing is asynchronous.

Operational order

1. List languages, templates, and hook title templates when you need codes or style names.
2. Create a project from video_url, upload a file, or generate magic clips from YouTube or an upload.
3. Optionally add user media (B-roll, music) via the media library before or during project create.
4. Use the project wait tool or poll get until transcription finishes.
5. Export the final rendered video when ready.
6. Publish to connected social accounts, then track posts via list published / publication analytics.

Data Model

• Languages — transcription language codes (for example en, es).
• Templates — caption style presets (Hormozi, Beast, Sara, and others).
• Hook title templates — animated opening caption styles.
• User media — library assets referenced by userMediaId in items and music.
• Projects — async jobs with status, transcription progress, and download URLs when complete.
• Publications — social posts with per-platform analytics.

Gotchas

• Async processing: Use the project wait tool, poll get, or set webhook_url — do not assume immediate results.
• Language codes: Always take codes from the languages list; do not guess ISO codes.
• File uploads: Use file_url for large videos; file_content_base64 is capped at 1 MB inline. Desktop stages local files when no public URL exists.
• Publishing: Connect social accounts in the Submagic publishing dashboard before publish calls.
• Rate limits: Project creation is limited (~30/hour). Languages and templates are lightweight.