Mga Madalas Itanong

Lahat ng kailangan mong malaman tungkol sa Pexafy. Hindi mo makita ang sagot mo? Makipag-ugnayan sa amin.

Pagsisimula

Ano ang Pexafy?

Ang Pexafy ay isang AI-powered na search engine para sa mga larawan na nag-aagregat ng milyun-milyong libreng at premium na larawan mula sa iba't ibang pinagkukunan — Unsplash, Pexels, Pixabay, Wikimedia Commons, at marami pa — sa isang API. Sa halip na i-integrate ang dose-dosenang serbisyo ng larawan, isang kahilingan lang ang gagawin mo sa Pexafy at makukuha mo ang pinakamahusay na mga resulta mula sa lahat ng pinagkukunan, na inayos ayon sa kaugnayan ng AI semantic.

Paano ako makakakuha ng API key?

Mag-sign up para sa libreng account sa pexafy.com/auth/register/, pagkatapos ay pumunta sa Dashboard → API Keys → Create Key. Ang iyong unang key ay nalilikha agad nang hindi kailangan ng credit card. Kasama sa libreng plano ang 1K na kahilingan sa API bawat buwan.

Libre bang gamitin ang Pexafy?

Oo! Ang aming libreng plano ay nagbibigay sa iyo ng 1K na kahilingan sa API bawat buwan — hindi kailangan ng credit card. Maaari kang maghanap gamit ang mga text-based na query at ma-access ang lahat ng libreng pinagkukunan ng larawan. Kailangan ng mas maraming kahilingan, premium na larawan, o image-to-image na paghahanap? Tingnan ang aming pahina ng Pricing para sa mga Pro at Business na plano.

Anong mga pinagkukunan ng larawan ang hinahanap ng Pexafy?

Kasalukuyang nag-aagregat ang Pexafy ng mga larawan mula sa Unsplash, Pexels, Pixabay, Wikimedia Commons, at Openverse. Patuloy kaming nagdadagdag ng mga bagong pinagkukunan. Maaari mong i-filter ang mga resulta ayon sa pinagkukunan gamit ang parameter na source sa API.

Paano naiiba ang Pexafy sa Google Images?

Ang Pexafy ay isang API na nakatuon sa mga developer, hindi isang consumer na search engine. Nag-aagregat lamang kami ng mga pinagkukunang libre gamitin at Creative Commons, kaya ligtas gamitin sa iyong produkto ang bawat resulta. Naiintindihan ng aming AI model ang semantikong kahulugan — maghanap ng 'cozy autumn vibes' at makakuha ng mga kaugnay na larawan, hindi lamang mga tugma sa keyword. Bukod dito, makakakuha ka ng mga nakaayos na JSON na tugon, pagination, mga filter, at analytics ng paggamit — lahat sa pamamagitan ng isang REST API.

Nag-aalok ba kayo ng mga SDK o client library?

Kasalukuyan kaming nagbibigay ng REST API na may komprehensibong dokumentasyon. Ang mga opisyal na SDK para sa Python, JavaScript/TypeScript, at PHP ay nasa aming roadmap. Samantala, madaling i-integrate ang API — isang HTTPS na kahilingan lamang na may API key header. Tingnan ang aming docs para sa mga halimbawa ng code sa iba't ibang wika.

API at Teknikal

Ano ang limitasyon ng rate ng API?

Ang mga limitasyon sa rate ay nakasalalay sa iyong plano: Free — 20 na kahilingan/minuto, Pro — 60 na kahilingan/minuto, Business — 300 na kahilingan/minuto. Kung lalampas ka sa limitasyon, makakatanggap ka ng tugon na 429 Too Many Requests na may header na Retry-After na nagpapakita kung kailan ka maaaring subukang muli.

Anong mga format ang ibinabalik ng API?

Lahat ng tugon ay JSON na may karaniwang envelope: {success, data, meta, pagination, error}. Kasama sa bawat object ng larawan ang: id, title, description, urls (thumbnail, small, regular, full, raw), photographer (name, url), source, license, dimensions, colors, at relevance score.

Paano ko hawahawakan ang pagination?

Gumagamit ang Pexafy ng cursor-based na pagination. Kasama sa bawat tugon ang value na pagination.next_cursor. Ipasa ito bilang parameter na cursor sa iyong susunod na kahilingan upang makuha ang sumusunod na pahina. Kapag ang next_cursor ay null, naabot mo na ang dulo.

Maaari ko bang i-filter ang mga resulta ng paghahanap?

Oo! Maaari kang mag-filter ayon sa: color_name (red, blue, green…), color_hex (hal. #FF5733 na may opsyonal na color_tolerance), orientation (landscape, portrait, square), source (unsplash, pexels, pixabay…), at score_threshold (minimum na kaugnayan 0.0–1.0). Pagsamahin ang mga filter para sa mas tumpak na mga resulta.

Paano ko oi-authenticate ang mga kahilingan sa API?

Idagdag ang iyong API key bilang request header: X-Api-Key: pxfy_your_key_here. Bilang alternatibo, gumamit ng Bearer token authentication: Authorization: Bearer <jwt_token>. Huwag ibahagi ang iyong API key sa client-side na code.

Ano ang maximum na bilang ng mga resulta bawat kahilingan?

Maaari kang humiling ng hanggang 80 resulta bawat pahina gamit ang per_page na parameter (ang default ay 20). Para sa malalaking hanay ng resulta, gumamit ng cursor-based pagination upang makuha ang mga kasunod na pahina. Walang limitasyon sa kabuuang bilang ng mga pahinang maaari mong pagsamahin.

Sinusuportahan ba ng Pexafy ang mga query sa paghahanap sa maraming wika?

Oo! Ang aming modelo ay sinanay sa multilingual na datos, kaya maaari kang maghanap sa Ingles, Pranses, Espanyol, Aleman, Portuges, at marami pang ibang wika. Ang semantic na pag-unawa ay pinakamahusay sa Ingles, ngunit karamihan sa mga karaniwang query sa ibang wika ay nagbibigay ng tumpak na resulta. Inirerekomenda namin ang Ingles para sa pinakamataas na katumpakan.

Pagsingil at Mga Plano

Maaari ba akong baguhin ang aking plano?

Oo, maaari kang mag-upgrade o mag-downgrade anumang oras mula sa Dashboard → Billing. Ang mga pag-upgrade ay magkakabisa kaagad na may prorated na pagsingil. Ang mga pag-downgrade ay magkakabisa sa pagtatapos ng iyong kasalukuyang panahon ng pagsingil. Lahat ay awtomatikong pinamamahalaan sa pamamagitan ng Stripe.

Ano ang mangyayari kung malampasan ko ang aking quota?

Ang mga kahilingan sa API ay haharangin kapag naabot mo na ang iyong buwanang limitasyon — makakatanggap ka ng 429 na tugon na may impormatibong mensahe ng error. Upang patuloy na gamitin ang API, mag-upgrade sa mas mataas na plano mula sa Dashboard → Billing.

Nag-aalok ba kayo ng mga refund?

Nag-aalok kami ng 14-araw na money-back guarantee sa lahat ng bayad na plano. Kung hindi ka nasiyahan sa loob ng unang 14 na araw ng pag-subscribe, makipag-ugnayan sa amin sa [email protected] at mag-isyu kami ng buong refund, walang mga tanong.

Anong mga paraan ng pagbabayad ang tinatanggap ninyo?

Tinatanggap namin ang lahat ng pangunahing credit at debit card (Visa, Mastercard, American Express), pati na rin ang Apple Pay at Google Pay — lahat ay ligtas na pinoproseso sa pamamagitan ng Stripe. Hindi namin iniimbak ang anumang impormasyon sa pagbabayad sa aming mga server.

Mayroon bang pangmatagalang kontrata?

Walang kontrata, walang pangako. Ang lahat ng plano ay buwan-buwan (o may diskwentong taunang pagbabayad kung pipiliin mo). Mag-cancel anumang oras mula sa Dashboard → Billing sa isang click. Ang iyong access ay magpapatuloy hanggang sa katapusan ng kasalukuyang panahon ng pagsingil.

Mayroon bang taunang diskwento?

Oo! Ang pagbabayad nang taunan ay nakakatipid ng humigit-kumulang 17%: Ang Pro ay $290/taon ($24/buwan) sa halip na $29/buwan. Ang Business ay $2990/taon ($249/buwan) sa halip na $299/buwan. Lumipat sa taunang plano mula sa Dashboard → Billing.

Nag-aalok ba kayo ng mga custom na enterprise na plano?

Oo! Kung ang iyong mga pangangailangan ay lumagpas sa Business na plano — mas mataas na mga limitasyon sa rate, dedikadong imprastraktura, custom na SLA, o on-premise na deployment — makipag-ugnayan sa amin sa [email protected] na may iyong mga kinakailangan. Magtatayo kami ng naakma na plano para sa iyong organisasyon.

Anong mga currency ang sinusuportahan ninyo para sa pagbabayad?

Lahat ng presyo ay nakalista sa USD. Ang Stripe, ang aming processor ng pagbabayad, ay awtomatikong nagko-convert sa iyong lokal na currency sa checkout. Maaaring mag-apply ang iyong bangko ng maliit na bayad sa foreign exchange depende sa uri ng iyong card at bansa.

Mga Larawan at Lisensya

Pagmamay-ari ba ng Pexafy ang mga larawan?

Hindi. Ang Pexafy ay isang search engine — nag-i-index at naghahanap kami ng mga larawang naka-host sa mga third-party na platform (Unsplash, Pexels, Pixabay, atbp.). Hindi namin iniimbak, ino-host, o ipinamamahagi ang mga aktwal na file ng larawan. Ang lahat ng larawan ay nananatiling pag-aari ng kani-kanilang mga photographer at platform.

Maaari ko bang gamitin ang mga larawan para sa mga komersyal na layunin?

Depende ito sa lisensya ng pinagmulan. Ang Unsplash, Pexels, at Pixabay ay nag-aalok ng libreng lisensya para sa komersyal na paggamit para sa karamihan ng kanilang mga larawan. Gumagamit ang Wikimedia Commons at Openverse ng iba't ibang lisensya ng Creative Commons — ang ilan ay nagbibigay-pahintulot sa komersyal na paggamit, ang ilan ay hindi. Palaging suriin ang field ng lisensya sa tugon ng API at i-verify sa source URL bago gamitin ang isang larawan para sa komersyal na layunin.

Ano ang pagkakaiba ng mga premium na larawan?

Ang mga premium na larawan ay lumalabas sa mga resulta ng paghahanap ngunit maaaring mangailangan ng subscription o pagbili sa pinagmulan upang ma-download sa buong resolusyon. Ang API ay nagbabalik ng mga preview/thumbnail para sa lahat ng larawan. Sa Free at Pro na mga plano, ang source URL sa tugon ay magsasabi sa iyo kung saan maa-access ang buong larawan.

Maaari ba akong mag-download ng mga larawan sa pamamagitan ng API?

Nagbabalik ang Pexafy ng mga URL sa mga larawang naka-host sa kanilang mga orihinal na platform — hindi kami direktang nagse-serve ng mga image file sa pamamagitan ng API. Para sa mga libreng larawan (Unsplash, Pexels, Pixabay), maaari kang mag-download ng buong resolusyon na larawan mula sa source URL na ibinigay sa tugon. Palaging igalang ang mga tuntunin ng serbisyo ng pinagmulang platform.

Gaano kadalas ina-update ang index ng larawan?

Ang aming indexing pipeline ay tumatakbo araw-araw para sa lahat ng pangunahing pinagmulan. Ang mga bagong larawang na-upload sa Unsplash, Pexels, Pixabay, at iba pang mga platform ay karaniwang mahahanap sa pamamagitan ng Pexafy sa loob ng 24–48 na oras. Ang aming index ay kasalukuyang naglalaman ng mahigit 5 milyong larawan at patuloy na lumalaki araw-araw.

Account at Seguridad

Paano ko ide-delete ang aking account?

Pumunta sa Dashboard → Settings → Danger Zone → Delete Account. Ang pagtanggal ng account ay permanente at aalisin ang lahat ng iyong mga API key, kasaysayan ng paggamit, at personal na datos. Maaari ka ring mag-email sa amin sa [email protected] upang humiling ng pagtanggal sa ilalim ng GDPR/karapatang burahin.

Ligtas ba ang aking datos?

Oo. Gumagamit kami ng HTTPS sa lahat ng dako, bcrypt para sa pag-hash ng password, at nag-iimbak ng mga session sa Redis gamit ang mga short-lived JWT token. Hindi namin ibinebenta o ibinabahagi ang iyong datos sa mga third party. Ang mga API key ay hina-hash bago iimbak. Basahin ang aming Privacy Policy para sa buong detalye ng mga gawi sa datos.

Maaari ba akong magkaroon ng maraming API key?

Oo, depende sa iyong plano: Free (1 key), Pro (5 keys), Business (∞ keys). Ang maraming key ay nagbibigay-daan sa iyo na paghiwalayin ang paggamit ayon sa aplikasyon, kapaligiran (dev/staging/prod), o miyembro ng koponan, at bawiin ang mga indibidwal na key nang hindi nakakaapekto sa iba.

Ano ang mangyayari kung ang aking API key ay nakompromiso?

Agad na bawiin ang nakompromisong key mula sa Dashboard → API Keys at gumawa ng bago. Ang pagbawi ay magkakabisa kaagad — anumang mga kahilingang gumagamit ng lumang key ay tatanggihan na may 401 na error. Huwag kailanman i-commit ang mga API key sa version control; gumamit ng mga environment variable sa halip.

Ano ang inyong garantiya sa uptime?

Nagta-target kami ng 99.9 porsyentong uptime para sa availability ng API. Ang mga customer na nasa Business plan ay tumatanggap ng SLA na may mga pangako sa uptime. Maaari mong subaybayan ang real-time at makasaysayang katayuan ng serbisyo sa aming pahina ng Status, na maa-access mula sa footer ng site na ito.

Sumusunod ba ang Pexafy sa GDPR?

Oo. Nangongolekta lamang kami ng pinakamababang datos na kailangan upang mapatakbo ang serbisyo (email, hashed na password, mga log ng paggamit). Hindi namin ibinebenta ang datos sa mga third party. Maaari kang humiling ng buong pag-export ng datos o pagtanggal anumang oras mula sa Dashboard → Settings o sa pamamagitan ng pag-email sa [email protected]. Tingnan ang aming Privacy Policy para sa buong detalye.

May mga tanong pa rin?

Hindi mo makita ang hinahanap mo? Masaya ang aming team na tumulong.

Makipag-ugnayan sa Suporta Basahin ang API Docs

Tungkol sa Pexafy Blog