Export and publishing

Export re-renders the video from the current document — with all edits and the chosen style — and saves a file with the settings you specify. Export is free. Right after rendering, Slicer can publish the video to your connected social accounts.

Start an export#

curl https://api.slicer.media/v1/projects/318/export \
  -H "Authorization: Bearer $SLICER_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"profile":{"resolution":"1080p","fps":30,"quality":"high"}}'

The response is the project with the queued status: an export is a run just like a montage, with stages and progress from 0 to 100%. Wait for succeeded by polling GET /v1/projects/{id} or with the export.succeeded webhook.

If an export fails or is stopped, the project stays ready with the previous video — nothing is lost. While rendering is in progress, edits and a new export answer 409 busy.

For a project without the AI director, the first successful export turns the draft (draft) into a finished project (succeeded); a failed one leaves it a draft. The number of free exports of such projects per day is limited: beyond it the response is 429 daily_export_limit.

File settings#

profile is optional: without it the video gets the Social profile. You can pass only some fields — the rest use their defaults.

Ready-made presets — GET /v1/export-presets:

More on the settings in the guide Export: presets and file settings.

Download the video and cover#

curl -f -o reel.mp4 "https://api.slicer.media/v1/projects/318/result" \
  -H "Authorization: Bearer $SLICER_TOKEN"

curl -f -o cover.jpg "https://api.slicer.media/v1/projects/318/poster" \
  -H "Authorization: Bearer $SLICER_TOKEN"

• The file type follows the container: video/mp4 or video/quicktime; the extension is in the project's result.container.
• Range requests are supported: downloads can be resumed and the video played with seeking.
• ?version=902 — the file of a specific version from GET /v1/projects/{id}/versions.
• Parameters of the finished file (frame size, codec, frame rate, bitrate) are in result.info.

There are no download links without a token: the file is served only to its owner. To show the video to someone, give them the appUrl link — the project opens in the web app after signing in.

Publishing to social networks#

Publishing requires the publish scope. The social account must first be connected in the app — Profile → Social accounts: signing in to a platform needs the owner's browser and can't be done through the API.

1. Find the connected accounts

   curl https://api.slicer.media/v1/social/accounts -H "Authorization: Bearer $SLICER_TOKEN"

   {
     "ok": true,
     "data": [
       { "id": 41, "platform": "youtube", "name": "Studio Anna", "status": "active", "apiPublishing": true },
       { "id": 42, "platform": "instagram", "name": "anna.studio", "status": "active", "apiPublishing": true },
       { "id": 43, "platform": "tiktok", "name": "anna.studio", "status": "active", "apiPublishing": false }
     ]
   }

   apiPublishing: false means you can't publish to this account through the API: access has expired or it's TikTok.

2. Export with publishing

   {
     "profile": { "resolution": "1080p" },
     "publish": [
       {
         "accountId": 41,
         "title": "A reel in 3 minutes",
         "caption": "How to make a reel from a single video #shorts",
         "options": { "youtube": { "privacy": "public", "madeForKids": false } }
       },
       {
         "accountId": 42,
         "caption": "A reel in 3 minutes ✂️ #reels",
         "options": { "instagram": { "shareToFeed": true } }
       }
     ]
   }

   Publishing starts right after rendering. Up to 8 accounts per export.

3. Track the publications

   GET /v1/projects/{id}/publications — the status of each publication: waiting (waiting for the render), queued, uploading, processing (the platform is processing it), published (url links to the video), failed (errorCode has the reason), cancelled. The same events arrive as the publication.published and publication.failed webhooks.

Platform settings in options:

title is the title (YouTube, VK, up to 150 characters), caption — the description and hashtags (up to 5000 characters). Slicer takes care of each platform's file requirements: if needed, a separate copy of the file is made for each network.

What's next#