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 berbasis AI yang mengumpulkan jutaan gambar bebas pakai dari 9 sumber — Unsplash, Pexels, Pixabay, Kaboompics, Burst dan lainnya — ke dalam satu API. Satu permintaan Pexafy = satu pencarian semantik di seluruh 9 sumber. Dengan API milik penyedia sendiri, pencarian yang sama membutuhkan 3 hingga 5 panggilan, ditambah logika penggabungan dan normalisasi JSON: kode yang harus Anda tulis, pelihara, dan bayar.
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 5K permintaan API per bulan.
Apakah saya perlu mendapatkan persetujuan aplikasi saya?
Tidak. Kunci Anda langsung berfungsi pada panggilan pertama: tanpa tinjauan aplikasi, tanpa periode tunggu, dan tanpa kewajiban melakukan panggilan pelacakan unduhan pada setiap unduhan. Unsplash membatasi aplikasi yang belum disetujui hingga 50 permintaan/jam sampai aplikasi Anda ditinjau; Pexels mengizinkan 200/jam.
Apakah Pexafy gratis digunakan?
Ya! Paket Free kami memberi Anda 5K permintaan API per bulan — tanpa kartu kredit — dan mencari di semua sumber yang diindeks Pexafy, sama seperti paket lainnya. Butuh lebih banyak permintaan? Paket berbayar, dari Starter hingga Enterprise, menaikkan batasnya: lihat halaman Harga kami.
Sumber gambar apa saja yang dicari Pexafy?
Pexafy saat ini mengumpulkan 9 sumber, yang terbesar adalah Unsplash, Pexels, Pixabay, Kaboompics, Burst. 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, ganti paket kapan saja dari Dashboard → Billing. Perubahan berlaku langsung dan Creem, reseller kami, menghitungnya secara prorata: pindah ke paket yang lebih tinggi dikenai selisih harga untuk sisa periode Anda saat ini, pindah ke paket yang lebih rendah mengembalikan selisih tersebut.
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. Creem, reseller kami, mengembalikannya ke metode pembayaran asli Anda. Detail ada di Kebijakan Pengembalian Dana kami: pexafy.com/legal/refund/
Metode pembayaran apa yang Anda terima?
Pembayaran diproses oleh Creem, reseller dan Merchant of Record kami. Anda dapat membayar dengan kartu kredit atau debit, atau dengan metode pembayaran lain yang ditawarkan Creem saat checkout di negara Anda. Kami tidak pernah melihat atau menyimpan detail kartu Anda.
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 hingga 18%: Pro adalah $199/tahun ($17/bulan) sebagai ganti $19/bulan. Business adalah $2599/tahun ($217/bulan) sebagai ganti $249/bulan. Beralih ke tahunan melalui Dashboard → Billing.
Apakah Anda menawarkan paket enterprise khusus?
Ya! Jika kebutuhan Anda melebihi paket Enterprise — 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, dan Creem, reseller kami, menagihnya dalam USD. Pajak seperti PPN dapat ditambahkan saat checkout tergantung negara Anda. Jika kartu Anda memakai mata uang lain, bank Anda akan mengonversi jumlahnya dan mungkin mengenakan sedikit biaya penukaran mata uang.
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?
Hal ini bergantung pada lisensi sumber. Unsplash, Pexels, dan Pixabay semuanya menawarkan lisensi penggunaan komersial gratis untuk sebagian besar gambar mereka, dan sumber-sumber kecil yang kami indeks mengikuti model yang sama. Selalu periksa kolom lisensi dalam respons API dan verifikasi di URL sumber sebelum menggunakan gambar secara komersial.
Apakah saya membayar gambarnya?
Tidak. Pexafy tidak menjual gambar. Setiap hasil berasal dari pustaka yang bebas digunakan — Unsplash, Pexels, Pixabay, Kaboompics, Burst dan lainnya — dan menautkan kembali ke sana, di bawah lisensi pustaka tersebut. Paket Anda hanya membayar layanan pencarian: permintaan API, batas laju, kunci API, dan dukungan. Periksa lisensi setiap gambar di sumbernya sebelum menggunakannya.
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. 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 9M+ 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