Boosta Video Api

Overview

Use this skill to execute end-to-end Boosta API workflows: submit job, poll until completion, return clip URLs, and handle common API failures.
Prefer the bundled script for deterministic execution and consistent error handling.

Quick Start Workflow

1. 1. Validate required inputs:

• - video_url (required)
• INLINECODE1 (required, see references/video-types.md)
• INLINECODE2 (optional)

1. 2. Validate credentials:

• - Require BOOSTA_API_KEY in environment.
• Never print or store raw API keys in output.

1. 3. Submit job:

• - Endpoint: INLINECODE4
• Base URL: INLINECODE5
• Body: video_url, video_type, optional INLINECODE8

1. 4. Poll status:

• - Endpoint: INLINECODE9
• Stop when status=completed or status=failed.
• If completed, return clip_urls.

1. 5. Handle API errors:

• - 401: invalid or missing key
• INLINECODE14: invalid payload (missing video_url, invalid video_type)
• INLINECODE17: no credits
• INLINECODE18: rate limited (respect retry_after)
• INLINECODE20: reuse returned job_id and continue polling

Commands

Use the bundled script:

CODEBLOCK0

Submit and wait for completion:

CODEBLOCK1

Check status:

CODEBLOCK2

List completed jobs:

CODEBLOCK3

Check usage:

CODEBLOCK4

Output Contract

When user asks to create clips, return:

• - INLINECODE22
• final INLINECODE23
• INLINECODE24 if present
• INLINECODE25 when completed
• clear next step if processing/failed

When user asks only to check status, return:

• - INLINECODE26
• current INLINECODE27
• INLINECODE28/step if present

Decision Rules

• - If user does not provide video_type, infer it with references/video-types.md and state inference explicitly.
• If API returns active_job_exists, continue with provided job_id instead of creating another job.
• On 429, wait retry_after seconds (fallback to 60 if missing) and retry.
• Keep polling interval between 10 and 20 seconds to avoid spam.
• Avoid parallel job submission per key because API allows one active job at a time.

References

• - API overview and endpoint contracts: references/api-reference.md
• Video type selection: references/video-types.md
• Error handling playbook: references/errors.md