Convert a video
Convert a video to mp4, webm, mov, or gif (video→gif is palette-optimized).
An animated GIF input converts to any video target (gif→mp4). Synchronous — the
converted file’s download URL is in the response.
Pricing: 10 credits per conversion, charged only on success. Estimate via
POST /v1/cost with
{"model": "convert-video"}.
file accepts a public URL (up to 30 MB), an uploaded-file URL from
POST /v1/uploads (up to 50 MB), a data
URI, or raw base64. Videos must be 30 seconds or shorter. Results are stored
privately and deleted after 7 days.
Authorizations
API key as a bearer token: Authorization: Bearer bpx_live_xxx
Body
Response
Converted. Download from url (valid several hours; file kept 7 days).
A completed format conversion. Download from url.
"image/webp"
Credits charged for this conversion (2 image / 10 video / 3 audio).
Suggested download filename.
"photo.webp"
"7 days"
Converted file size in bytes.
Signed download URL for the converted file (valid several hours; the file itself is kept 7 days).