Media API

Upload an image or video to XBeast storage. Use the returned HTTPS url as tweets[].media_url when creating a post. You can also skip this endpoint and pass any public HTTPS media URL.

Upload a file

POST/api/v1/media

Send multipart/form-data with a single field named file.

Limits

Kind	Max size	Formats
Kind	Max size	Formats
Image	5 MB	PNG, JPEG, GIF, WebP
Video	100 MB	MP4, MOV (QuickTime), WebM

Response (201)

{
  "url": "https://....supabase.co/storage/v1/object/public/images/USER_ID/uuid.jpg",
  "type": "image"
}

type is image or video.

curl

curl -X POST "https://xbeast.io/api/v1/media" \
  -H "Authorization: Bearer xb_live_YOUR_KEY" \
  -F "file=@/path/to/image.jpg"