Create short-lived S3 PUT descriptors before publishing any local file. This is Adeli's recommended media transport for Instagram, Facebook, TikTok, YouTube, X, Bluesky, and LinkedIn. File bytes go directly to private S3 rather than through a Vercel Function.
clientId is your correlation value and must be unique inside the request.
Use post_media for normal media and youtube_thumbnail only for a YouTube
JPEG or PNG thumbnail. Counts, MIME types, and sizes are checked against the
selected platform before any capability is issued. For linkedin, a request
declares up to 20 files: JPEG, PNG, or GIF images up to 20 MB each, an MP4
video up to 500 MB, or a PDF up to 100 MB.
To post the same file to several platforms, send platforms (for example
["instagram", "tiktok", "youtube"]) instead of platform. Each file is checked
against every listed platform's limits, so it must fit the strictest of them, and
its uploadId starts with shared/staging/. Use it in a
publication, or in a single-platform post
to any of the listed platforms. Give platform or platforms, not both.
The 201 response has one entry per declaration:
PUT the raw bytes to url with every returned header unchanged. Do not send
your Adeli API key to S3 and do not add or alter metadata. URLs expire after ten
minutes and grant access to one random object only. Uploads may run concurrently;
use clientId to restore the original order.
Then publish a small JSON request with staged references:
{
"platform": "youtube",
"profileId": "00000000-0000-4000-8000-000000000001",
"accountId": "00000000-0000-4000-8000-000000000002",
"title": "Launch",
"privacy_status": "unlisted",
"made_for_kids": false,
"video": { "upload_id": "youtube/staging/opaque.mp4" },
"thumbnail": { "upload_id": "youtube/staging/opaque.jpg" }
}Before contacting a provider, Adeli verifies the object's organization, profile,
platform, purpose, MIME declaration, and exact S3 byte length. Missing, expired,
or mismatched media returns 422 invalid_media. Retry initiation if a URL
expires. Retrying a single PUT restarts that file; resumable S3 multipart upload
is not part of this version.
API keys belong on your server. Do not expose one in browser code or request broad customer-origin bucket CORS.