ZenBlocks memungkinkan Anda mencari gambar dan video dari layanan eksternal langsung di dalam editor blok. Untuk mengaktifkan pencarian tersebut, Anda perlu mendaftarkan API key di Pengaturan > ZenBlocks > API Settings.
Kesimpulan
Jika ingin mencari gambar atau video langsung dari ZenBlocks, daftarkan terlebih dahulu API key untuk layanan yang ingin digunakan. Berikut 3 poin utama yang perlu diingat:
- Unsplash: Fokus pada foto. Perhatikan kredit dan ketentuan penggunaan saat memakai
- Pexels: Mendukung pencarian gambar dan video, mudah digunakan
- Pixabay: Mendukung pencarian gambar dan video, cocok untuk mencari materi bertipe CC0
Pexels dan Pixabay menggunakan API key yang sama untuk pencarian gambar dan video.
Pahami Terlebih Dahulu
ZenBlocks sendiri tidak menyimpan gambar maupun video. ZenBlocks menggunakan API key untuk mengirimkan permintaan ke layanan eksternal: “Tampilkan materi dengan kata kunci ini.”
Dengan kata lain, alurnya adalah:
- Mengatur API key
- Mencari gambar atau video di dalam editor blok
- Memilih dan menggunakan materi yang diinginkan
Apa Itu API Key
Secara sederhana, API key adalah semacam kartu izin akses untuk menggunakan suatu layanan.
- Jika API key belum diatur, pencarian tidak dapat dilakukan
- Jika key salah, akan muncul error
- Beberapa layanan memiliki batas penggunaan, proses verifikasi, atau ketentuan khusus
Layanan yang Didukung
| Layanan | Nama Item di Halaman Admin | Kegunaan Utama | Cocok Digunakan Saat |
|---|---|---|---|
| Unsplash | Unsplash Access Key | Pencarian gambar, pelacakan unduhan saat memilih | Mengutamakan tampilan visual foto |
| Pexels | Pexels API Key | Pencarian gambar, pencarian video | Ingin mencari gambar dan video dari satu layanan |
| Pixabay | Pixabay API Key | Pencarian gambar, pencarian video | Ingin menjelajahi berbagai jenis materi |
Perbedaan Antar Layanan
Unsplash
- Kualitas foto tinggi, cocok untuk halaman yang mengutamakan visual
- Di sisi ZenBlocks, pelacakan unduhan dijalankan saat gambar dipilih
- Sebaiknya selalu periksa syarat penggunaan dan kebijakan kredit sebelum menggunakan
Pexels
- Gambar dan video bisa diakses dari satu layanan, sehingga pengelolaan lebih sederhana
- Sangat praktis jika ingin mencari hingga video latar belakang dari satu layanan saja
- Pencarian gambar dan video menggunakan API key yang sama
Pixabay
- Gambar dan video bisa diakses dengan satu key
- Menyediakan materi yang relatif beragam, memudahkan pemilahan berdasarkan kebutuhan
- Menjadi pilihan yang tepat jika ingin mencari materi bertipe CC0
Apa Itu CC0
CC0 dapat dipahami sebagai "pengaturan publikasi yang memungkinkan penggunaan sebebas mungkin."
- Mudah digunakan untuk keperluan komersial
- Umumnya tidak mewajibkan pencantuman kredit
- Mudah untuk dimodifikasi dan digunakan ulang
Namun dalam praktiknya, "terlihat CC0 bukan berarti sepenuhnya bebas" — ini pemahaman yang lebih aman.
- Layanan mungkin memiliki syarat penggunaan tersendiri
- Jika terdapat wajah, logo, merek dagang, atau bangunan, perhatikan hak-hak terkait lainnya
- Cara paling pasti adalah memeriksa ketentuan layanan tempat materi dipublikasikan
Saat memilih materi di ZenBlocks, anggaplah CC0 sebagai indikator bahwa materi tersebut relatif mudah digunakan.
Langkah Pengaturan
- Buka Pengaturan > ZenBlocks
- Pilih tab API Settings di bagian atas
- Tempelkan API key untuk layanan yang ingin digunakan
- Klik Save API Settings
- Kembali ke editor blok, lalu coba pencarian gambar atau video dengan memilih layanan yang sesuai
Hubungan Gambar dan Video
- Unsplash terutama digunakan untuk pencarian gambar
- Pexels dapat digunakan untuk pencarian gambar dan video
- Pixabay juga dapat digunakan untuk pencarian gambar dan video
Artinya, jika Anda juga ingin menggunakan video, pengaturan key Pexels atau Pixabay adalah pilihan yang paling praktis.
Poin Verifikasi
- Apakah pencarian di Unsplash tidak menampilkan error API key missing?
- Apakah pencarian gambar di Pexels / Pixabay mengembalikan hasil?
- Apakah pencarian video di Pexels / Pixabay dapat langsung digunakan?
- Setelah memperbarui key, apakah perubahan tercermin setelah memuat ulang editor?
Catatan Penting
- Unsplash menjalankan pelacakan unduhan saat gambar dipilih
- Gambar dari Unsplash sebaiknya digunakan setelah memeriksa ketentuan penggunaan dan kebijakan kredit
- Pexels dan Pixabay tidak memisahkan key untuk gambar dan video — menggunakan nilai pengaturan yang sama
- Pencarian bisa tidak mengembalikan hasil karena rate limit atau izin yang tidak mencukupi di sisi API
Langkah Pemecahan Masalah
- Pastikan tidak ada kesalahan saat menempelkan key
- Muat ulang editor setelah menyimpan
- Periksa apakah key sudah diaktifkan di sisi layanan terkait
- Ganti provider di editor blok untuk mengidentifikasi layanan mana yang bermasalah
Cara Memilih Layanan
- Mengutamakan tampilan foto: mulai dengan Unsplash
- Ingin mencari gambar dan video sekaligus: mulai dengan Pexels
- Ingin menjelajahi berbagai jenis materi: pertimbangkan juga Pixabay
- Ingin menyederhanakan masalah lisensi: utamakan materi bertipe CC0