Pertanyaan yang Sering Diajukan
Semua yang perlu Anda ketahui tentang Pexafy. Tidak menemukan jawaban Anda? Hubungi kami.
Memulai
Apa itu Pexafy?
Pexafy adalah mesin pencari gambar bertenaga AI yang mengumpulkan jutaan gambar gratis dan premium dari berbagai sumber — Unsplash, Pexels, Pixabay, Wikimedia Commons, dan lainnya — ke dalam satu API. Alih-alih mengintegrasikan puluhan layanan gambar, Anda cukup membuat satu permintaan ke Pexafy dan mendapatkan hasil terbaik dari semua sumber, yang diurutkan berdasarkan relevansi semantik AI.
Bagaimana cara mendapatkan kunci API?
Daftar akun gratis di pexafy.com/auth/register/, lalu buka Dashboard → API Keys → Create Key. Kunci pertama Anda dibuat secara instan tanpa memerlukan kartu kredit. Paket gratis mencakup 1K permintaan API per bulan.
Apakah Pexafy gratis digunakan?
Ya! Paket Gratis kami memberi Anda 1K permintaan API per bulan — tanpa kartu kredit. Anda dapat mencari kueri berbasis teks dan mengakses semua sumber gambar gratis. Butuh lebih banyak permintaan, gambar premium, atau pencarian gambar-ke-gambar? Kunjungi halaman Harga kami untuk paket Pro dan Business.
Sumber gambar apa saja yang dicari Pexafy?
Pexafy saat ini mengumpulkan gambar dari Unsplash, Pexels, Pixabay, Wikimedia Commons, dan Openverse. Kami terus menambahkan lebih banyak sumber. Anda dapat memfilter hasil berdasarkan sumber menggunakan parameter source di API.
Apa perbedaan Pexafy dengan Google Images?
Pexafy adalah API yang diutamakan untuk pengembang, bukan mesin pencari untuk konsumen umum. Kami hanya mengumpulkan sumber gambar yang bebas digunakan dan berlisensi Creative Commons, sehingga setiap hasil aman digunakan dalam produk Anda. Model AI kami memahami makna semantik — cari 'cozy autumn vibes' dan dapatkan gambar yang relevan, bukan sekadar pencocokan kata kunci. Selain itu, Anda mendapatkan respons JSON terstruktur, pagination, filter, dan analitik penggunaan — semuanya melalui satu REST API.
Apakah Anda menyediakan SDK atau pustaka klien?
Kami saat ini menyediakan REST API dengan dokumentasi lengkap. SDK resmi untuk Python, JavaScript/TypeScript, dan PHP ada dalam roadmap kami. Sementara itu, API ini mudah diintegrasikan — cukup satu permintaan HTTPS dengan header kunci API. Lihat dokumentasi kami untuk contoh kode dalam berbagai bahasa.
API & Teknis
Berapa batas kecepatan API?
Batas kecepatan bergantung pada paket Anda: Gratis — 20 permintaan/menit, Pro — 60 permintaan/menit, Business — 300 permintaan/menit. Jika Anda melampaui batas, Anda akan menerima respons 429 Too Many Requests dengan header Retry-After yang menunjukkan kapan Anda dapat mencoba kembali.
Format apa yang dikembalikan oleh API?
Semua respons berupa JSON dengan envelope standar: {success, data, meta, pagination, error}. Setiap objek foto mencakup: id, title, description, urls (thumbnail, small, regular, full, raw), photographer (name, url), source, license, dimensions, colors, dan relevance score.
Bagaimana cara menangani pagination?
Pexafy menggunakan pagination berbasis kursor. Setiap respons menyertakan nilai pagination.next_cursor. Teruskan nilai ini sebagai parameter cursor dalam permintaan berikutnya untuk mendapatkan halaman selanjutnya. Jika next_cursor bernilai null, Anda telah mencapai akhir data.
Bisakah saya memfilter hasil pencarian?
Ya! Anda dapat memfilter berdasarkan: color_name (red, blue, green…), color_hex (misalnya #FF5733 dengan color_tolerance opsional), orientation (landscape, portrait, square), source (unsplash, pexels, pixabay…), dan score_threshold (relevansi minimum 0.0–1.0). Gabungkan filter untuk hasil yang lebih presisi.
Bagaimana cara mengautentikasi permintaan API?
Tambahkan kunci API Anda sebagai header permintaan: X-Api-Key: pxfy_your_key_here. Sebagai alternatif, gunakan autentikasi Bearer token: Authorization: Bearer <jwt_token>. Jangan pernah membagikan kunci API Anda dalam kode sisi klien.
Berapa jumlah maksimum hasil per permintaan?
Anda dapat meminta hingga 80 hasil per halaman menggunakan parameter per_page (default adalah 20). Untuk kumpulan hasil yang besar, gunakan pagination berbasis kursor untuk mengambil halaman berikutnya. Tidak ada batasan pada total jumlah halaman yang dapat Anda paginate.
Apakah Pexafy mendukung kueri pencarian multibahasa?
Ya! Model kami dilatih dengan data multibahasa, sehingga Anda dapat mencari dalam bahasa Inggris, Prancis, Spanyol, Jerman, Portugis, dan banyak bahasa lainnya. Pemahaman semantik bekerja paling baik dalam bahasa Inggris, namun sebagian besar kueri umum dalam bahasa lain menghasilkan hasil yang akurat. Kami merekomendasikan bahasa Inggris untuk presisi maksimal.
Penagihan & Paket
Bisakah saya mengubah paket saya?
Ya, Anda dapat meningkatkan atau menurunkan paket kapan saja melalui Dashboard → Billing. Peningkatan berlaku segera dengan penagihan prorata. Penurunan berlaku pada akhir periode penagihan Anda saat ini. Semuanya ditangani secara otomatis melalui Stripe.
Apa yang terjadi jika saya melebihi kuota saya?
Permintaan API akan diblokir setelah Anda mencapai batas bulanan — Anda akan menerima respons 429 dengan pesan kesalahan yang informatif. Untuk terus menggunakan API, tingkatkan ke paket yang lebih tinggi melalui Dashboard → Billing.
Apakah Anda menawarkan pengembalian dana?
Kami menawarkan garansi uang kembali 14 hari untuk semua paket berbayar. Jika Anda tidak puas dalam 14 hari pertama berlangganan, hubungi kami di [email protected] dan kami akan memberikan pengembalian dana penuh, tanpa pertanyaan apa pun.
Metode pembayaran apa yang Anda terima?
Kami menerima semua kartu kredit dan debit utama (Visa, Mastercard, American Express), serta Apple Pay dan Google Pay — semua diproses dengan aman melalui Stripe. Kami tidak menyimpan informasi pembayaran apa pun di server kami.
Apakah ada kontrak jangka panjang?
Tidak ada kontrak, tidak ada komitmen. Semua paket bersifat bulanan (atau diskon tahunan jika Anda memilih). Batalkan kapan saja melalui Dashboard → Billing dengan satu klik. Akses Anda berlanjut hingga akhir periode penagihan saat ini.
Apakah ada diskon tahunan?
Ya! Membayar tahunan menghemat sekitar 17%: Pro adalah $290/tahun ($24/bulan) sebagai ganti $29/bulan. Business adalah $2990/tahun ($249/bulan) sebagai ganti $299/bulan. Beralih ke tahunan melalui Dashboard → Billing.
Apakah Anda menawarkan paket enterprise khusus?
Ya! Jika kebutuhan Anda melebihi paket Business — batas laju yang lebih tinggi, infrastruktur khusus, SLA kustom, atau penerapan on-premise — hubungi kami di [email protected] dengan kebutuhan Anda. Kami akan menyusun paket yang disesuaikan untuk organisasi Anda.
Mata uang apa yang Anda dukung untuk pembayaran?
Semua harga tercantum dalam USD. Stripe, pemroses pembayaran kami, secara otomatis mengonversi ke mata uang lokal Anda saat checkout. Bank Anda mungkin mengenakan biaya penukaran mata uang asing yang kecil tergantung pada jenis kartu dan negara Anda.
Gambar & Lisensi
Apakah Pexafy memiliki gambar-gambar tersebut?
Tidak. Pexafy adalah mesin pencari — kami mengindeks dan mencari gambar yang dihosting di platform pihak ketiga (Unsplash, Pexels, Pixabay, dll.). Kami tidak menyimpan, menghosting, atau mendistribusikan ulang file gambar yang sebenarnya. Semua gambar tetap menjadi milik fotografer dan platform masing-masing.
Bisakah saya menggunakan gambar untuk keperluan komersial?
Bergantung pada lisensi sumbernya. Unsplash, Pexels, dan Pixabay semuanya menawarkan lisensi penggunaan komersial gratis untuk sebagian besar gambar mereka. Wikimedia Commons dan Openverse menggunakan berbagai lisensi Creative Commons — beberapa mengizinkan penggunaan komersial, beberapa tidak. Selalu periksa kolom lisensi dalam respons API dan verifikasi di URL sumber sebelum menggunakan gambar secara komersial.
Apa perbedaan gambar premium?
Gambar premium muncul di hasil pencarian, tetapi mungkin memerlukan langganan atau pembelian di sumber aslinya untuk mengunduh dalam resolusi penuh. API mengembalikan pratinjau/thumbnail untuk semua gambar. Pada paket Free dan Pro, URL sumber dalam respons akan memberi tahu Anda di mana mengakses gambar lengkapnya.
Bisakah saya mengunduh gambar melalui API?
Pexafy mengembalikan URL ke gambar yang di-hosting di platform aslinya — kami tidak menyajikan file gambar secara langsung melalui API. Untuk gambar gratis (Unsplash, Pexels, Pixabay), Anda dapat mengunduh gambar resolusi penuh dari URL sumber yang tersedia dalam respons. Selalu patuhi ketentuan layanan platform sumber.
Seberapa sering indeks gambar diperbarui?
Pipeline pengindeksan kami berjalan setiap hari untuk semua sumber utama. Gambar baru yang diunggah ke Unsplash, Pexels, Pixabay, dan platform lainnya biasanya dapat dicari melalui Pexafy dalam 24–48 jam. Indeks kami saat ini berisi lebih dari 5 juta gambar dan terus bertambah setiap hari.
Akun & Keamanan
Bagaimana cara menghapus akun saya?
Buka Dashboard → Settings → Danger Zone → Delete Account. Penghapusan akun bersifat permanen dan menghapus semua kunci API, riwayat penggunaan, serta data pribadi Anda. Anda juga dapat mengirim email ke [email protected] untuk meminta penghapusan berdasarkan GDPR/hak untuk dihapus.
Apakah data saya aman?
Ya. Kami menggunakan HTTPS di mana pun, bcrypt untuk hashing kata sandi, dan menyimpan sesi di Redis dengan token JWT berumur pendek. Kami tidak menjual atau berbagi data Anda dengan pihak ketiga. Kunci API di-hash sebelum disimpan. Baca Kebijakan Privasi kami untuk detail lengkap tentang praktik pengelolaan data.
Bisakah saya memiliki beberapa kunci API?
Ya, tergantung paket Anda: Free (1 kunci), Pro (5 kunci), Business (∞ kunci). Beberapa kunci memungkinkan Anda memisahkan penggunaan berdasarkan aplikasi, lingkungan (dev/staging/prod), atau anggota tim, serta mencabut kunci individual tanpa memengaruhi yang lain.
Apa yang harus dilakukan jika kunci API saya dikompromikan?
Segera cabut kunci yang dikompromikan dari Dashboard → API Keys dan buat kunci baru. Pencabutan berlaku secara instan — setiap permintaan menggunakan kunci lama akan ditolak dengan error 401. Jangan pernah menyimpan kunci API di version control; gunakan variabel lingkungan sebagai gantinya.
Apa jaminan uptime Anda?
Kami menargetkan uptime 99,9 persen untuk ketersediaan API. Pelanggan paket Business menerima SLA dengan komitmen uptime. Anda dapat memantau status layanan secara real-time dan historis di halaman Status kami, yang dapat diakses dari footer situs ini.
Apakah Pexafy mematuhi GDPR?
Ya. Kami hanya mengumpulkan data minimum yang diperlukan untuk mengoperasikan layanan (email, kata sandi yang di-hash, log penggunaan). Kami tidak menjual data kepada pihak ketiga. Anda dapat meminta ekspor data lengkap atau penghapusan kapan saja dari Dashboard → Settings atau dengan mengirim email ke [email protected]. Lihat Kebijakan Privasi kami untuk detail lengkap.
Tidak ada pertanyaan yang cocok dengan pencarian Anda. Coba istilah lain.
Tanya langsung kepada kamiMasih punya pertanyaan?
Tidak menemukan yang Anda cari? Tim kami dengan senang hati membantu.
Hubungi Dukungan Baca Dokumentasi API