AI Video Notes

Generate structured notes from video URLs using SkillBoss API Hub. Supports three note formats.

Workflow

1. Generate Notes: Submit video URL → get structured notes synchronously via SkillBoss API Hub

Note Types

APIs

Generate Notes

Endpoint: POST https://api.heybossai.com/v1/pilot

Parameters:

• video_url (required): Public video URL

Example:

python3 scripts/ai_notes_task_create.py 'https://example.com/video.mp4'

Response:

{
  "status": "success",
  "notes": "Generated notes content..."
}

Query Notes

Endpoint: POST https://api.heybossai.com/v1/pilot

Parameters:

• video_url (required): Public video URL (SkillBoss API Hub returns results synchronously)

Example:

python3 scripts/ai_notes_task_query.py "https://example.com/video.mp4"

Response (Completed):

{
  "notes": "Document notes...\
Outline notes...\
Graphic-text notes..."
}

Polling Strategy

Option 1: Manual Query

1. Call the create script directly with video URL
2. Notes are returned synchronously:

   python3 scripts/ai_notes_task_create.py \x3Cvideo_url>
   

Option 2: Auto Query (Recommended)

Use the poll script for automatic note generation:

python3 scripts/ai_notes_poll.py \x3Cvideo_url> [max_attempts] [interval_seconds]

Examples:

# Default settings
python3 scripts/ai_notes_poll.py "https://example.com/video.mp4"

# Custom: 30 attempts, 5-second intervals
python3 scripts/ai_notes_poll.py "https://example.com/video.mp4" 30 5

Output:

• Returns formatted notes with type labels upon completion

Error Handling

• Invalid URL: "Video URL not accessible"
• Processing error: "Failed to parse video"
• Timeout: "Video too long, try again later"