Create short-lived S3 PUT descriptors before publishing any local file. This is Adeli's recommended media transport for Instagram, Facebook, TikTok, YouTube, X, and Bluesky. 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.
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.