Publish a post
Publish a post to your public BudgetPixel feed — the same posts you create on the
site, so your local agent can publish on your behalf. Synchronous: the response
carries the live post’s id and url.
Pricing: 10 credits per successful post, charged only on success. Estimate via
POST /v1/cost with
{"model": "create-post"}.
Media composition (one of):
- Images — 1 to 6 images. Each image can optionally carry
modelandpromptgeneration info, shown on the image’s info panel on the post. - Video — exactly 1 video, optionally with up to 3 accompanying images.
- Audio — exactly 1 audio file (cannot mix with other media). Supports
song_name,genre, andlyrics.
Each media[].file accepts a public URL, an uploaded-file URL from
POST /v1/uploads, a data URI, or raw
base64. Size limits: images 15 MB; audio 50 MB; video 100 MB — note that URL
inputs are fetched with a 30 MB cap and uploads support up to 50 MB, so ~50 MB is
the practical video ceiling via the API.
Limits & moderation:
- The API allows 5 posts per hour, inside the site-wide limit of 20 posts
per hour per account across all surfaces (shares included) — both on top of
the API’s global rate limits. Exceeding any of them returns
429. - Posting a byte-identical file you’ve already posted returns
409with the existing post’s id. - Posts published through the API carry a public “via API” label, like posts made with an Ava companion carry hers.
- Image/video posts are reviewed after publishing (content rating and spam scoring). Feed and gallery visibility follow that review and your account standing; a post hidden by review is not refunded.
Authorizations
API key as a bearer token: Authorization: Bearer bpx_live_xxx
Body
The post's media items, in display order. One of: 1-6 images; OR exactly 1 video plus up to 3 images; OR exactly 1 audio file (audio can't mix with other media).
1 - 6 elementsOptional caption (max 2000 characters).
Audio posts only — must be one of the site's music genres.
Audio posts only.
Audio posts only — track title.
Response
Post published.
A published post.
10
The post id.
image, video, audio Image/video posts are rated after publish; feed visibility follows the review.
"pending"
Public URL of the post.
"https://budgetpixel.com/p/12345"