Skip to the page

Pictures and video

The Buzzmark API takes a picture or video 3 ways: an upload from your code, a copy from a public https link, or a picture Buzzmark's image model makes in your brand's colours.

Every file gets the app's checks and is kept in Buzzmark's own storage and your Library, so a post never depends on the link it came from.

Upload a file

  1. 1. Send POST /media/upload-url with the file's name, such as spring-menu.jpg. The answer has an upload_url, the header to send and an upload_id.

  2. 2. PUT the file's bytes to upload_url with exactly that Content-Type header and nothing else.

  3. 3. Send POST /media/from-upload with the upload_id, and a post_id to put it on a draft.

The upload link and its id work for 55 minutes.

A file already on the web goes in one step: POST /media/from-url with a public https link straight to the file. Buzzmark keeps its own copy. A link to a private or local address, a page instead of a file, or a file over its size is refused, and nothing is kept.

Have Buzzmark make a picture

POST /images takes a description and makes a picture in the brand's colours, marked Made with AI in the Library. Name a product exactly as the brand profile lists it, and its own photo is the reference. It takes about a minute and uses one of your plan's pictures for the month; a picture that's refused or fails isn't counted.

On a draft

With a post_id, every way in adds the file to that draft and answers what a platform on it would refuse, such as a shape Instagram doesn't take. In a thread, part picks the post, from 0. Alt text isn't taken yet. Pictures and video has each platform's rules.

EndpointRequestNeeds
Get an upload link for a filePOST /api/v1/media/upload-urlDraft
Keep an uploaded filePOST /api/v1/media/from-uploadDraft
Add a picture or video from a linkPOST /api/v1/media/from-urlDraft
Make a picturePOST /api/v1/imagesDraft

Where to next