videodb python

SDK Python VideoDB

Database Video untuk Aplikasi AI Anda
Jelajahi dokumen »

Lihat Demo · Laporkan Bug · Fitur Permintaan

SDK Python VideoDB

VideoDB Python SDK memungkinkan Anda berinteraksi dengan database tanpa server VideoDB. Kelola video sebagai data cerdas, bukan file. Ini terukur, hemat biaya & dioptimalkan untuk aplikasi AI dan integrasi LLM.

Instalasi

Untuk menginstal paket, jalankan perintah berikut di terminal Anda:

 pip install videodb

Mulai Cepat

Membuat Koneksi

Dapatkan kunci API dari konsol VideoDB. Gratis untuk 50 unggahan pertama (Tidak diperlukan kartu kredit) .

 import videodb
conn = videodb . connect ( api_key = "YOUR_API_KEY" )

Bekerja dengan Satu Video

---

⬆️ Mengunggah Video

Sekarang Anda telah membuat koneksi ke VideoDB, Anda dapat mengunggah video Anda menggunakan conn.upload() . Anda dapat langsung mengupload dari youtube , any public url , S3 bucket , atau local file path . Koleksi default dibuat saat Anda membuat koneksi pertama.

metode upload mengembalikan objek Video .

 # Upload a video by url
video = conn . upload ( url = "https://www.youtube.com/watch?v=WDv4AWk0J3U" )

# Upload a video from file system
video_f = conn . upload ( file_path = "./my_video.mp4" )

Lihat Video Anda

Setelah diunggah, video Anda langsung tersedia untuk dilihat dalam resolusi 720p. ⚡️

• Hasilkan url yang dapat dialirkan untuk video menggunakan video.generate_stream()
• Pratinjau video menggunakan video.play(). Ini akan membuka video di browser/notebook default Anda

 video . generate_stream ()
video . play ()

⛓️ Streaming Bagian Video Tertentu

Anda dapat dengan mudah memotong bagian tertentu dari video dengan memasukkan garis waktu stempel waktu mulai dan berakhir (dalam detik) sebagai parameter. Misalnya, ini akan menghasilkan dan memutar kompilasi 10 seconds pertama dan klip antara detik 120th dan 140th .

 stream_link = video . generate_stream ( timeline = [[ 0 , 10 ], [ 120 , 140 ]])
play_stream ( stream_link )

? Cari di Dalam Video

Untuk mencari bit di dalam video, Anda harus index video tersebut terlebih dahulu. Hal ini dapat dilakukan dengan perintah sederhana. Pengindeksan PS mungkin memerlukan waktu untuk video yang lebih panjang.

 video . index_spoken_words ()
result = video . search ( "Morning Sunlight" )
result . play ()
video . get_transcript ()

Videodb meluncurkan lebih banyak opsi pengindeksan di versi mendatang. Saat ini Anda dapat mencoba indeks semantic - Indeks berdasarkan kata-kata yang diucapkan.

Di masa mendatang, Anda dapat mengindeks video menggunakan:

1. Adegan - Konsep dan peristiwa visual.
2. Wajah .
3. Indeks domain tertentu seperti Sepak Bola, Bisbol, Rekaman Drone, Kriket, dll.

Melihat Hasil Pencarian

video.search() mengembalikan objek SearchResults , yang berisi bagian atau sebagaimana kami menyebutnya, shots video yang secara semantik cocok dengan permintaan pencarian Anda.

• result.get_shots() Mengembalikan daftar Shot(s) yang cocok dengan permintaan pencarian.
• result.play() Mengembalikan url yang dapat diputar untuk video (mirip dengan video.play(); Anda dapat membuka tautan ini di browser, atau menyematkannya ke situs web Anda menggunakan iframe).

RAG: Cari di dalam Banyak Video

---

VideoDB dapat menyimpan dan mencari di dalam banyak video dengan mudah. Secara default, video diunggah ke koleksi default Anda.

Menggunakan Koleksi untuk Mengunggah Banyak Video

 # Get the default collection
coll = conn . get_collection ()

# Upload Videos to a collection
coll . upload ( url = "https://www.youtube.com/watch?v=lsODSDmY4CY" )
coll . upload ( url = "https://www.youtube.com/watch?v=vZ4kOr38JhY" )
coll . upload ( url = "https://www.youtube.com/watch?v=uak_dXHh6s4" )

• conn.get_collection() : Mengembalikan objek Koleksi; koleksi bawaan.
• coll.get_videos() : Mengembalikan daftar objek Video; semua video dalam koleksi.
• coll.get_video(video_id) : Mengembalikan objek Video, video yang sesuai dari video_id yang disediakan.
• coll.delete_video(video_id) : Menghapus video dari Koleksi.

Cari Di Dalam Koleksi

Anda cukup mengindeks semua video dalam koleksi dan menggunakan metode pencarian untuk menemukan hasil yang relevan. Di sini kami mengindeks konten lisan dari suatu koleksi dan melakukan pencarian semantik.

 # Index all videos in collection
for video in coll . get_videos ():
    video . index_spoken_words ()

# search in the collection of videos
results = coll . search ( query = "What is Dopamine?" )
results . play ()

Hasilnya di sini memiliki semua bit yang cocok dalam satu aliran dari koleksi Anda. Anda dapat langsung menggunakan hasil ini dalam aplikasi Anda.

? Jelajahi objek Video

Ada beberapa metode yang tersedia pada Objek Video, yang dapat berguna untuk kasus penggunaan Anda.

Dapatkan Transkripnya

 # words with timestamps
text_json = video . get_transcript ()
text = video . get_transcript_text ()
print ( text )

Tambahkan Subtitle ke video

Ini mengembalikan aliran baru secara instan dengan subtitle ditambahkan ke video.

 new_stream = video . add_subtitle ()
play_stream ( new_stream )

Dapatkan Gambar Kecil Video:

video.generate_thumbnail() : Mengembalikan gambar mini video.

Menghapus video:

video.delete() : Menghapus video.

Lihat lebih banyak contoh dan tutorial Membangun dengan VideoDB untuk menjelajahi apa yang dapat Anda bangun dengan VideoDB .

---

Peta jalan

• Menambahkan Lebih Banyak Indeks: Face , Scene , Security , Events , dan Sports
• Berikan dukungan cepat untuk membuat thumbnail menggunakan GenAI.
• Berikan dukungan cepat untuk mengakses konten.
• Berikan dukungan cepat untuk mengedit video.
• Lihat masalah yang masih terbuka untuk mengetahui daftar fitur yang diusulkan (dan masalah umum).

---

Berkontribusi

Kontribusi inilah yang membuat komunitas open source menjadi tempat yang luar biasa untuk belajar, menginspirasi, dan berkreasi. Setiap kontribusi yang Anda berikan sangat dihargai .

1. Garpu Proyek
2. Buat Cabang Fitur Anda ( git checkout -b feature/AmazingFeature )
3. Komit Perubahan Anda ( git commit -m 'Add some AmazingFeature' )
4. Dorong ke Cabang ( git push origin feature/AmazingFeature )
5. Buka Permintaan Tarik

---