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. Validate required inputs:
2. video_url (required)
3. video_type (required, see references/video-types.md)

4. config_name (optional)

5. Validate credentials:

6. Require BOOSTA_API_KEY in environment.

7. Never print or store raw API keys in output.

8. Submit job:

9. Endpoint: POST /api/v1/jobs
10. Base URL: https://boosta.pro/api/v1

11. Body: video_url, video_type, optional config_name

12. Poll status:

13. Endpoint: GET /api/v1/jobs/:job_id
14. Stop when status=completed or status=failed.

15. If completed, return clip_urls.

16. Handle API errors:

17. 401: invalid or missing key
18. 400: invalid payload (missing video_url, invalid video_type)
19. 403: no credits
20. 429: rate limited (respect retry_after)
21. active_job_exists: reuse returned job_id and continue polling

Commands

Use the bundled script:

python3 scripts/boosta_job.py --help

Submit and wait for completion:

export BOOSTA_API_KEY="sk_live_..."
python3 scripts/boosta_job.py submit 
  --video-url "https://youtube.com/watch?v=xxx" 
  --video-type "conversation" 
  --config-name "My Config" 
  --wait

Check status:

python3 scripts/boosta_job.py status --job-id "job_1234567890_abc123"

List completed jobs:

python3 scripts/boosta_job.py list

Check usage:

python3 scripts/boosta_job.py usage

Output Contract

When user asks to create clips, return: - job_id - final status - clips_count if present - clip_urls when completed - clear next step if processing/failed

When user asks only to check status, return: - job_id - current status - progress/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