Timestamps, Clips, Streams

results = video.search("car chase scene")

# Access individual shots
for shot in results.get_shots():
    print(f"{shot.start}s - {shot.end}s: {shot.text}")
    print(f"Score: {shot.search_score}")

# Play all matching segments
results.play()

# Generate a stream URL
stream_url = video.generate_stream(results)
print(stream_url)

results = video.search("introduction to the topic")

# Get all shots
shots = results.get_shots()

# Access first result
first_shot = shots[0]
print(f"Starts at: {first_shot.start}")
print(f"Ends at: {first_shot.end}")
print(f"Content: {first_shot.text}")
print(f"Relevance: {first_shot.search_score}")

results = video.search("product demo")
results.play()

results = video.search("funny moments")
shots = results.get_shots()

# Play just the first match
shots[0].play()

results = video.search("highlight reel")
stream_url = video.generate_stream(results)
# Returns: https://stream.videodb.io/v3/...

# Generate stream from specific time ranges
timestamps = [
    (10.5, 25.0),   # First segment
    (45.0, 60.0),   # Second segment
    (120.0, 135.5)  # Third segment
]

stream_url = video.generate_stream(timestamps)

results = video.search("key moments")

# Get as list of tuples
timestamps = [(shot.start, shot.end) for shot in results.get_shots()]
# [(5.2, 15.0), (45.5, 52.3), (120.0, 145.8)]

def merge_timestamps(timestamps):
    """Merge overlapping time ranges"""
    if not timestamps:
        return []

    sorted_ts = sorted(timestamps)
    merged = [list(sorted_ts[0])]

    for start, end in sorted_ts[1:]:
        if start <= merged[-1][1]:
            merged[-1][1] = max(merged[-1][1], end)
        else:
            merged.append([start, end])

    return merged

# Merge results from multiple searches
ts1 = [(10, 20), (15, 25)]
ts2 = [(22, 30), (50, 60)]
merged = merge_timestamps(ts1 + ts2)
# [[10, 30], [50, 60]]

results = video.search("important moments")

# Get high-confidence results only
shots = results.get_shots()
high_confidence = [s for s in shots if s.search_score > 0.5]

results = video.search("long segments")

# Get segments longer than 10 seconds
shots = results.get_shots()
long_segments = [s for s in shots if (s.end - s.start) > 10]