Python SDK

pip install vidnavigator

from vidnavigator import VidNavigatorClient

# It's recommended to load the API key from an environment variable
import dotenv
dotenv.load_dotenv()
client = VidNavigatorClient()
# Alternatively, you can pass it directly:
# client = VidNavigatorClient(api_key="YOUR_API_KEY")

from vidnavigator import VidNavigatorClient

with VidNavigatorClient(api_key="YOUR_API_KEY") as vn:
    results = vn.analyze_video(
        video_url="https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        query="What is the main topic discussed?")
    print(results)

try:
    result = client.get_transcript(
        video_url="https://www.youtube.com/watch?v=dQw4w9WgXcQ"
    )
    print(result.data.video_info.title)
    print(result.data.transcript)
    # GET all the metadata in a dictionary
    print(result.data.video_info.model_dump())
    # Print data as a pretty string
    print(result.data.model_dump_json(indent=2))
except Exception as e:
    print(f"An error occurred: {e}")

try:
    result = client.transcribe_video(
        video_url="https://www.instagram.com/reel/C86ZvEaqRmo/"
    )
    print(result.data.video_info.title)
    # Print first segment of the transcript
    print(result.data.transcript[0].text)
except Exception as e:
    print(f"An error occurred: {e}")

try:
    analysis_data = client.analyze_video(
        video_url="https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        query="What is the main topic of this song?"
    )
    print(analysis_data.transcript_analysis)
except Exception as e:
    print(f"An error occurred: {e}")

try:
    search_results = client.search_videos(
        query="What are the best practices for React development?"
    )
    for video in search_results.data['results']:
        print(f"- {video['title']}")
except Exception as e:
    print(f"An error occurred: {e}")

try:
    # Asynchronous upload (returns immediately)
    upload_response = client.upload_file(
        "path/to/your/video.mp4",
        wait_for_completion=False
    )
    print(f"File uploaded with ID: {upload_response['file_id']}")
except Exception as e:
    print(f"An error occurred: {e}")

try:
    # Get the first 10 completed files
    files_response = client.get_files(limit=10, status="completed")
    for file_info in files_response.data.files:
        print(f"- {file_info.file_name} (ID: {file_info.file_id})")
except Exception as e:
    print(f"An error occurred: {e}")

try:
    file_id = "your_file_id_here"
    file_details = client.get_file(file_id)
    print(file_details)
except Exception as e:
    print(f"An error occurred: {e}")

try:
    file_id = "your_file_id_here"
    url_response = client.get_file_url(file_id)
    print(f"Temporary URL: {url_response['data']['file_url']}")
except Exception as e:
    print(f"An error occurred: {e}")

try:
    file_id = "your_failed_file_id_here"
    retry_response = client.retry_file_processing(file_id)
    print(retry_response)
except Exception as e:
    print(f"An error occurred: {e}")

try:
    file_id = "your_processing_file_id_here"
    cancel_response = client.cancel_file_upload(file_id)
    print(cancel_response)
except Exception as e:
    print(f"An error occurred: {e}")

try:
    file_id = "your_file_id_here"
    delete_response = client.delete_file(file_id)
    print(delete_response)
except Exception as e:
    print(f"An error occurred: {e}")

try:
    analysis_data = client.analyze_file(
        file_id="your_file_id_here",
        query="What are the key topics discussed in the first half?"
    )
    print(analysis_data.transcript_analysis)
except Exception as e:
    print(f"An error occurred: {e}")

try:
    search_results = client.search_files(
        query="Customer feedback on pricing"
    )
    for result in search_results.data['results']:
        print(f"- Found in: {result['file_name']}, Score: {result['relevance_score']}")
except Exception as e:
    print(f"An error occurred: {e}")

try:
    usage_data = client.get_usage()
    print(usage_data)
except Exception as e:
    print(f"An error occurred: {e}")

try:
    health_status = client.health_check()
    print(health_status)
except Exception as e:
    print(f"An error occurred: {e}")