io.github.MkTurner74/botverse

Cancel an in-progress workflow. All queued and dispatched steps are marked CANCELLED. Completed steps are not reversed. You are only billed for steps that completed before cancellation.

Mux a separate video file and audio file (both public HTTPS URLs) into one fresh-encoded output — combine two sources, and reconcile a frame-rate or duration mismatch between them. Default options.method 'mux' just combines both streams as-is. For a real mismatch: 'resample_video' (cheap frame duplicate/drop to options.target_framerate, real-time duration unchanged), 'interpolate_video' (motion-compensated retime — smoother, much slower), or 'speed_conform' (true pulldown-style retime: every source frame kept but played at options.target_framerate, so duration changes by source_fps/target_fps and audio is time-stretched by the same ratio — the classic 24→25fps NTSC/PAL-speed conform). options.duration_policy: 'shortest' (default, trim to the shorter stream) or 'match_video' (silence-pad audio to the video's exact length). Output formats: mp4, webm, mov_prores. Returns a job_id — poll get_job_status until 'complete', then get_download_url.

Mux an already-uploaded video and audio file (both from get_upload_url) into one fresh-encoded output. Same conform methods and options as conform_from_url — use for local files or files too large to fetch by URL. Poll get_job_status until 'complete', then get_download_url.

Concatenate an ordered list of video and/or still-image segments (all public HTTPS URLs) into one continuous, fresh-encoded output — the video 'splice' step. Put an image segment first for a head slate/bumper, last for a tail slate/end card, or in the middle for a mid-roll insert/cutaway — or use all-video segments to splice two or more real clips together back-to-back. Each segment is {type: 'video', url} or {type: 'image', url, duration_seconds}. Needs at least 2 segments (max 8) and at least one type 'video' segment — its resolution and frame rate become the output's defaults. Segments are scaled to fit and letterboxed (not stretched) if aspect ratios differ; any segment without audio gets a matching silent track synthesised. Output formats: mp4, webm, mov_prores. Returns a job_id — poll get_job_status until 'complete', then get_download_url.

Concatenate an ordered list of already-uploaded video and/or still-image segments (all from get_upload_url) into one continuous, fresh-encoded output. Same segment shape, slate/bumper/end-card/insert use cases, and options as conform_splice_from_url — use for local files or files too large to fetch by URL. Poll get_job_status until 'complete', then get_download_url.

Offload an inline document conversion to Botverse — pass the content directly as a string. PREFER this when you already have the content (text, or base64 for binary Office files). Inline limit: 4 MB. For larger files, use convert_from_url (public URL or cloud share link) or get_upload_url + convert_file. Supported inputs: md, html, rst, txt, doc, docx, pptx, ppt, xlsx (PowerPoint inputs convert to pdf only). Supported outputs: docx (Word), pdf, html, txt, md, rst, xlsx (tables extracted). Office documents (Word, PowerPoint, Excel) render to PDF with full page layout — Excel PDFs honor the workbook's print areas and page setup; optional single_page_sheets scales each sheet onto exactly one PDF page. Binary inputs (doc, docx, pptx, ppt, xlsx) require encoding "base64". Flat fee $0.05 per file.

Offload a document conversion to Botverse using an already-uploaded file. Workflow: (1) call get_upload_url to get a presigned upload URL, (2) PUT the raw file bytes to that URL, (3) call convert_file with the object_key — Botverse handles the rest server-side. Returns a job_id immediately so you can continue with other tasks while conversion runs. Supported inputs: md, html, rst, txt, doc, docx, pptx, ppt, xlsx (PowerPoint inputs convert to pdf only). Supported outputs: docx (Word), pdf, html, txt, md, rst, xlsx (tables extracted). Office documents (Word, PowerPoint, Excel) render to PDF with full page layout — Excel PDFs honor the workbook's print areas and page setup; optional single_page_sheets scales each sheet onto exactly one PDF page. Poll get_job_status until complete, then get_download_url. Flat fee $0.05 per file.

Offload a document conversion to Botverse — runs server-side in seconds, returns a download link, and frees you to continue with other tasks while it processes. Use this when the source document is at a public URL. Accepts share links from Dropbox, Google Drive, OneDrive (personal or business), SharePoint, and Box directly — pass the share URL as-is; they auto-resolve to the file. Also works with any direct HTTPS download URL. If you already have the content as a string, use convert_content instead — no upload step needed. Supported inputs: md, html, rst, txt, doc, docx, pptx, ppt, xlsx (PowerPoint inputs convert to pdf only). Supported outputs: docx (Word), pdf, html, txt, md, rst, xlsx (tables extracted). Office documents (Word, PowerPoint, Excel) render to PDF with full page layout — Excel PDFs honor the workbook's print areas and page setup; optional single_page_sheets scales each sheet onto exactly one PDF page. Returns a job_id immediately. Poll get_job_status every 5s until 'complete', then get_download_url. Flat fee $0.05 per file.

Get a presigned HTTPS URL to download the completed output file. Call after get_job_status returns 'complete'. URL expires in 24 hours.

Poll the status of a transcode, convert, or transcribe job. Call every 5 seconds until status is 'complete' or 'failed'. Status 'queued' or 'processing' is normal — large files take 5–15 minutes; transcribe reports a live stage (converting audio → transcribing → AI augmenting → rendering). Keep polling indefinitely until a terminal status is reached. Do not stop polling after a fixed number of attempts.

Get a presigned PUT URL to upload any file — video, audio, or document (markdown, HTML, DOCX, etc.). The URL expires in 15 minutes. PUT raw file bytes directly to the URL. After upload, pass the object_key to transcode_video (for video) or convert_file (for documents).

Check the current prepaid wallet balance for this Botverse account. Use before large batch jobs to confirm sufficient funds.

Get the current status of a workflow and all its steps. Each call may advance the workflow by dispatching steps whose dependencies have completed. Poll every 5–10 seconds until status is COMPLETED, FAILED, PARTIALLY_FAILED, or CANCELLED.

Submit a multi-step workflow to the Botverse workflow engine. Steps execute in dependency order; parallel branches (multiple steps with the same depends_on) run simultaneously. Returns a workflow_id immediately — poll get_workflow_status every 5–10 seconds until terminal. INTER-STEP REFERENCES: pass a prior step's output into a later step with the string "$.steps.<step_id>.output_key" (e.g. a docx→pdf chain: step to_pdf has depends_on: ["to_docx"] and inputs {"source_url": "$.steps.to_docx.output_key", "input_format": "docx", "output_format": "pdf"} using tool convert_from_url). Workflow params are referenced as "$.params.<name>". No other template syntax (${...} etc.) is supported. BILLING: convert-only workflows run on wallet balance ($0.05/step). Workflows containing transcode or transcribe steps require auto-refill to be enabled at botverse.cloud/dashboard/billing (their cost scales with source duration). Workflow definition uses BWDL (Botverse Workflow Definition Language) — schema at botverse.cloud/schemas/workflow/v1.json.

Offload a video or audio transcode to Botverse using a public URL — no upload step needed. Accepts share links from Dropbox, Google Drive, OneDrive (personal or business), SharePoint, and Box directly — pass the share URL as-is; they auto-resolve to the file. Also works with any direct HTTPS download URL. Limited to 2 GB. Returns a job_id immediately. IMPORTANT: tell the user the job_id right away so they can track it. Then poll get_job_status every 5 seconds. Large video files (>100 MB) can take 5–15 minutes — keep polling until status is 'complete' or 'failed', no matter how many polls it takes. Never give up early. Wallet debited on completion. Use options.start_time and options.duration to trim — e.g. start_time='00:01:00', duration=120 for a 2-minute clip.

Offload a video transcode to Botverse — encoding runs server-side so you can continue with other tasks. Returns a job_id immediately. Source must be ≤ 60 minutes and ≤ 2 GB. Poll get_job_status every 5 seconds until 'complete', then get_download_url. Wallet debited on completion.

Transcribe a video or audio file from a public HTTPS URL into a speaker-labelled transcript — ONE call does everything. Accepts share links from Dropbox, Google Drive, OneDrive (personal or business), SharePoint, and Box directly — pass the share URL as-is; they auto-resolve to the file. Also works with any direct HTTPS download URL. Internally: converts to audio, runs speech-to-text with speaker diarization, uses AI to name the speakers from your attendee list, and renders the document. Pass options.attendees (names, optional gender/role) and it tags who said what. Output formats: txt, json, srt, vtt, docx, pdf. CONSENT: you must have all parties' consent to record/transcribe. Returns a job_id immediately — report it to the user, then poll get_job_status (it reports a live stage: converting audio → transcribing → AI augmenting → rendering) until 'complete', then get_download_url. ~$0.05/audio-minute (~$3/hour), diarization + naming included.

Transcribe an already-uploaded video/audio file (from get_upload_url) into a speaker-labelled transcript. Same one-call pipeline and options as transcribe_from_url (attendee naming, srt/vtt, formatted docx/pdf). Use for local files or files larger than a URL fetch allows (up to 2 GB). CONSENT: you must have all parties' consent. Poll get_job_status (live stage) until complete, then get_download_url. ~$0.05/audio-minute (~$3/hour).