Metadata-Version: 2.4
Name: sotavideo.ai
Version: 1767090.300.657
Summary: High-quality integration for https://sotavideo.ai/
Home-page: https://sotavideo.ai/
Author: SuperMaker
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python
Dynamic: summary

# sotavideo.ai

The `sotavideo.ai` package provides a streamlined interface for interacting with the sotavideo.ai platform, enabling automated workflows for video analysis and processing. This library simplifies the integration process, allowing users to easily leverage the advanced capabilities offered by sotavideo.ai.

## Installation

To install the `sotavideo.ai` package, use pip:
bash
pip install sotavideo.ai

## Basic Usage

Here are a few examples showcasing how to use the `sotavideo.ai` package:

**1. Analyzing Video Content for Object Detection:**

This example demonstrates how to use the package to detect objects within a video file.
python
import sotavideo.ai

api_key = "YOUR_API_KEY" # Replace with your actual API key
video_path = "path/to/your/video.mp4"

try:
    analysis_results = sotavideo.ai.analyze_video(api_key, video_path, task="object_detection")
    print("Object Detection Results:", analysis_results)

except sotavideo.ai.APIError as e:
    print(f"Error during analysis: {e}")
except FileNotFoundError:
    print(f"Error: Video file not found at {video_path}")
except Exception as e:
    print(f"An unexpected error occurred: {e}")

**2. Extracting Keyframes from a Video:**

This example shows how to extract keyframes from a video based on scene changes.
python
import sotavideo.ai

api_key = "YOUR_API_KEY" # Replace with your actual API key
video_path = "path/to/your/video.mp4"
output_directory = "path/to/output/keyframes"

try:
    sotavideo.ai.extract_keyframes(api_key, video_path, output_directory)
    print(f"Keyframes extracted and saved to: {output_directory}")

except sotavideo.ai.APIError as e:
    print(f"Error during keyframe extraction: {e}")
except FileNotFoundError:
    print(f"Error: Video file not found at {video_path}")
except OSError as e:
    print(f"Error creating output directory: {e}")
except Exception as e:
    print(f"An unexpected error occurred: {e}")

**3. Generating a Video Summary:**

This example illustrates how to generate a concise summary of a video's content.
python
import sotavideo.ai

api_key = "YOUR_API_KEY" # Replace with your actual API key
video_path = "path/to/your/video.mp4"

try:
    summary = sotavideo.ai.generate_video_summary(api_key, video_path)
    print("Video Summary:", summary)

except sotavideo.ai.APIError as e:
    print(f"Error generating summary: {e}")
except FileNotFoundError:
    print(f"Error: Video file not found at {video_path}")
except Exception as e:
    print(f"An unexpected error occurred: {e}")

**4. Transcribing Audio from a Video:**

This example demonstrates how to transcribe the audio content of a video.
python
import sotavideo.ai

api_key = "YOUR_API_KEY"
video_path = "path/to/your/video.mp4"

try:
    transcription = sotavideo.ai.transcribe_video(api_key, video_path)
    print("Video Transcription:", transcription)

except sotavideo.ai.APIError as e:
    print(f"Error during transcription: {e}")
except FileNotFoundError:
    print(f"Error: Video file not found at {video_path}")
except Exception as e:
    print(f"An unexpected error occurred: {e}")


## Feature List

*   **Video Analysis:** Analyze video content for various tasks, including object detection, scene recognition, and more.
*   **Keyframe Extraction:** Extract representative frames from a video based on scene changes or other criteria.
*   **Video Summarization:** Generate concise summaries of video content, highlighting key events and information.
*   **Audio Transcription:** Transcribe the audio track of a video into text.
*   **API Integration:** Provides a seamless interface for interacting with the sotavideo.ai API.
*   **Error Handling:** Includes robust error handling to gracefully manage potential issues during processing.

## License

MIT License

This project is a gateway to the sotavideo.ai ecosystem. For advanced features and full capabilities, please visit: https://sotavideo.ai/
