Maswali Yanayoulizwa Mara kwa Mara
Kila kitu unachohitaji kujua kuhusu Pexafy. Hupati jibu lako? Wasiliana nasi.
Kuanza
Pexafy ni nini?
Pexafy ni injini ya utafutaji wa picha inayotumia AI ambayo inakusanya mamilioni ya picha zinazoweza kutumika bila malipo kutoka vyanzo 9 — Unsplash, Pexels, Pixabay, Kaboompics, Burst na zaidi — katika API moja. Ombi moja la Pexafy = utafutaji mmoja wa kisemantiki kupitia vyanzo vyote 9. Kwa kutumia API za watoa huduma moja kwa moja, utafutaji huo huo unahitaji miito 3 hadi 5, pamoja na mantiki ya kuunganisha na usanifishaji wa JSON: msimbo unaouandika, kuutunza na kulipa.
Ninawezaje kupata ufunguo wa API?
Jisajili akaunti ya bure kwenye pexafy.com/auth/register/, kisha nenda Dashboard → API Keys → Create Key. Ufunguo wako wa kwanza unatengenezwa mara moja bila kuhitaji kadi ya mkopo. Mpango wa bure unajumuisha 5K maombi ya API kwa mwezi.
Je, ninahitaji kupata idhini ya programu yangu?
Hapana. Ufunguo wako unafanya kazi mara ya kwanza kabisa unayoitumia: hakuna ukaguzi wa ombi, hakuna kipindi cha kusubiri, na hakuna simu ya lazima ya kufuatilia upakuaji inayohitajika kwa kila upakuaji. Unsplash inaweka kikomo cha maombi 50 kwa saa kwa programu ambazo hazijakaguliwa hadi itakapokagua programu yako; Pexels inaruhusu 200 kwa saa.
Je, Pexafy ni bure kutumia?
Ndiyo! Mpango wetu wa Free unakupa maombi 5K ya API kwa mwezi — bila kadi ya mkopo — na hutafuta katika kila chanzo ambacho Pexafy inaorodhesha, kama mpango mwingine wowote. Unahitaji maombi zaidi? Mipango ya kulipia, kuanzia Starter hadi Enterprise, huongeza viwango: tazama ukurasa wetu wa Bei.
Pexafy inatafuta picha kutoka vyanzo vipi?
Pexafy kwa sasa inakusanya vyanzo 9, vikubwa zaidi vikiwa Unsplash, Pexels, Pixabay, Kaboompics, Burst. Tunaendelea kuongeza zaidi. Unaweza kuchuja matokeo kwa chanzo kwa kutumia kigezo cha source katika API.
Pexafy inatofautiana vipi na Google Images?
Pexafy ni API inayolenga wasanidi programu, si injini ya kutafuta kwa watumiaji wa kawaida. Tunakusanya vyanzo vya bure na vya Creative Commons pekee, hivyo kila matokeo ni salama kutumia katika bidhaa yako. Mfano wetu wa AI unaelewa maana ya kisemantiki — tafuta 'cozy autumn vibes' upate picha zinazofaa, si tu mechi za maneno muhimu. Pia unapata majibu ya JSON yaliyopangwa, ukurasa kwa ukurasa, vichujio, na takwimu za matumizi — vyote kupitia API moja ya REST.
Je, mnatoa SDK au maktaba za mteja?
Kwa sasa tunatoa API ya REST yenye nyaraka za kina. SDK rasmi za Python, JavaScript/TypeScript, na PHP zipo katika mpango wetu wa baadaye. Wakati huo huo, API ni rahisi kuunganisha — ombi moja tu la HTTPS na kichwa cha ufunguo wa API. Angalia nyaraka zetu kwa mifano ya msimbo katika lugha kadhaa.
API na Kiufundi
Kiwango cha juu cha maombi ya API ni kipi?
Mipaka ya kiwango inategemea mpango wako: Bure — 20 maombi/dakika, Pro — 60 maombi/dakika, Business — 300 maombi/dakika. Ukizidi kiwango, utapokea jibu la 429 Too Many Requests yenye kichwa cha Retry-After kinachoonyesha unaweza kurudia lini.
Umbizo gani unarudishwa na API?
Majibu yote ni JSON yenye bahasha ya kawaida: {success, data, meta, pagination, error}. Kila kitu cha picha kinajumuisha: id, title, description, urls (thumbnail, small, regular, full, raw), photographer (name, url), source, license, dimensions, colors, na alama ya umuhimu.
Ninawezaje kushughulikia ukurasa kwa ukurasa?
Pexafy inatumia ukurasa kwa ukurasa unaotegemea kursor. Kila jibu linajumuisha thamani ya pagination.next_cursor. Ipitishe kama kigezo cha cursor katika ombi lako lijalo kupata ukurasa unaofuata. Wakati next_cursor ni null, umefika mwisho.
Je, ninaweza kuchuja matokeo ya utafutaji?
Ndiyo! Unaweza kuchuja kwa: color_name (red, blue, green…), color_hex (k.m. #FF5733 na color_tolerance ya hiari), orientation (landscape, portrait, square), source (unsplash, pexels, pixabay…), na score_threshold (umuhimu wa chini 0.0–1.0). Unganisha vichujio kwa matokeo sahihi zaidi.
Ninawezaje kuthibitisha maombi ya API?
Ongeza ufunguo wako wa API kama kichwa cha ombi: X-Api-Key: pxfy_your_key_here. Vinginevyo, tumia uthibitishaji wa tokeni ya Bearer: Authorization: Bearer <jwt_token>. Usishiriki ufunguo wako wa API katika msimbo wa upande wa mteja.
Idadi ya juu ya matokeo kwa kila ombi ni ngapi?
Unaweza kuomba hadi matokeo 80 kwa ukurasa mmoja ukitumia kigezo cha per_page (chaguo-msingi ni 20). Kwa seti kubwa za matokeo, tumia ukurasa wa msingi wa kielelezo ili kupata kurasa zinazofuata. Hakuna kikomo cha jumla ya kurasa unazoweza kupitia.
Je, Pexafy inasaidia maswali ya utafutaji katika lugha nyingi?
Ndiyo! Mfano wetu ulifunzwa kwa data ya lugha nyingi, kwa hivyo unaweza kutafuta kwa Kiingereza, Kifaransa, Kihispania, Kijerumani, Kireno, na lugha nyingine nyingi. Uelewa wa kisemantiki hufanya kazi vizuri zaidi kwa Kiingereza, lakini maswali mengi ya kawaida katika lugha nyingine hutoa matokeo sahihi. Tunapendekeza Kiingereza kwa usahihi wa hali ya juu.
Bili na Mipango
Je, ninaweza kubadilisha mipango yangu?
Ndiyo, badilisha mpango wakati wowote kutoka Dashboard → Billing. Mabadiliko yanaanza mara moja na Creem, muuzaji wetu, huyakokotoa kwa uwiano: kuhamia mpango wa juu hutoza tofauti ya bei kwa muda uliobaki wa kipindi chako cha sasa, kuhamia mpango wa chini huirudisha.
Nini kinatokea nikizidi kiwango changu cha matumizi?
Maombi ya API yanazuiwa ukifikia kikomo chako cha kila mwezi — utapokea jibu la 429 pamoja na ujumbe wa hitilafu wenye maelezo. Ili kuendelea kutumia API, panda daraja hadi mpango wa juu zaidi kutoka Dashboard → Billing.
Je, mnatoa marejesho ya pesa?
Tunatoa dhamana ya kurudisha pesa ndani ya siku 14 kwa mipango yote ya kulipwa. Kama hujaridhika ndani ya siku 14 za kwanza za kujisajili, wasiliana nasi kupitia [email protected] na tutakurudishia pesa yako yote bila masharti yoyote. Creem, muuzaji wetu, huirudisha kwenye njia yako ya awali ya malipo. Maelezo zaidi katika Sera yetu ya Kurejesha Pesa: pexafy.com/legal/refund/
Je, mnakubali njia gani za malipo?
Malipo yanashughulikiwa na Creem, muuzaji wetu na Merchant of Record. Unaweza kulipa kwa kadi ya mkopo au ya benki, au kwa njia nyingine za malipo ambazo Creem inatoa wakati wa kulipa katika nchi yako. Hatuoni wala kuhifadhi maelezo ya kadi yako kamwe.
Je, kuna mkataba wa muda mrefu?
Hakuna mikataba, hakuna masharti. Mipango yote ni ya mwezi hadi mwezi (au ya kila mwaka yenye punguzo ukichagua hivyo). Futa usajili wakati wowote kutoka Dashboard → Billing kwa kubonyeza mara moja. Ufikiaji wako unaendelea hadi mwisho wa kipindi cha sasa cha bili.
Je, kuna punguzo la kila mwaka?
Ndiyo! Kulipa kwa mwaka hupunguza bei kwa hadi 18%: Pro ni $199/mwaka ($17/mwezi) badala ya $19/mwezi. Business ni $2599/mwaka ($217/mwezi) badala ya $249/mwezi. Badilisha hadi malipo ya kila mwaka kutoka Dashboard → Billing.
Je, mnatoa mipango maalum ya biashara kubwa?
Ndiyo! Kama mahitaji yako yanazidi mpango wa Enterprise — vikomo vya juu zaidi vya kasi, miundombinu iliyotengwa, SLA maalum, au usambazaji ndani ya shirika — wasiliana nasi kupitia [email protected] ukielezea mahitaji yako. Tutaunda mpango maalum kwa ajili ya shirika lako.
Je, mnasaidia sarafu gani kwa malipo?
Bei zote zimeorodheshwa kwa USD, na Creem, muuzaji wetu, huzitoza kwa USD. Kodi kama VAT zinaweza kuongezwa wakati wa kulipa kulingana na nchi yako. Kadi yako ikitumia sarafu nyingine, benki yako hubadilisha kiasi hicho na inaweza kutoza ada ndogo ya kubadilisha fedha.
Picha na Leseni
Je, Pexafy inamiliki picha hizo?
Hapana. Pexafy ni injini ya utafutaji — tunaindeksi na kutafuta picha zilizohifadhiwa kwenye majukwaa ya watu wengine (Unsplash, Pexels, Pixabay, n.k.). Hatuhifadhi, hatutunzi, wala kusambaza faili halisi za picha. Picha zote zinabaki kuwa mali ya wapiga picha na majukwaa yao husika.
Je, ninaweza kutumia picha kwa madhumuni ya kibiashara?
Inategemea leseni ya chanzo. Unsplash, Pexels, na Pixabay zote zinatoa leseni za matumizi ya kibiashara bila malipo kwa picha nyingi zao, na vyanzo vidogo tunavyoindeksi vinafuata mfano huo huo. Daima kagua sehemu ya leseni katika jibu la API na thibitisha kwenye URL ya chanzo kabla ya kutumia picha kibiashara.
Je, ninalipia picha?
Hapana. Pexafy haiuzi picha. Kila tokeo linatoka kwenye maktaba ya picha za kutumia bure — Unsplash, Pexels, Pixabay, Kaboompics, Burst na nyinginezo — na linaunganisha kurudi huko, chini ya leseni ya maktaba hiyo. Mpango wako unalipia huduma ya utafutaji pekee: maombi ya API, viwango vya kasi, funguo za API na usaidizi. Kagua leseni ya kila picha kwenye chanzo chake kabla ya kuitumia.
Je, ninaweza kupakua picha kupitia API?
Pexafy inarudisha URL za picha zilizohifadhiwa kwenye majukwaa yao ya asili — hatuhudumii faili za picha moja kwa moja kupitia API. Unaweza kupakua picha yenye azimio kamili kutoka kwa URL ya chanzo iliyotolewa katika jibu. Daima heshimu masharti ya huduma ya jukwaa la chanzo.
Faharasa ya picha inasasishwa mara ngapi?
Mfumo wetu wa kuorodhesha unafanya kazi kila siku kwa vyanzo vikuu vyote. Picha mpya zilizopakiwa kwenye Unsplash, Pexels, Pixabay, na majukwaa mengine kwa kawaida zinaweza kutafutwa kupitia Pexafy ndani ya masaa 24–48. Faharasa yetu kwa sasa ina picha 9M+ na inaendelea kukua kila siku.
Akaunti na Usalama
Jinsi ya kufuta akaunti yangu?
Nenda kwenye Dashboard → Settings → Danger Zone → Delete Account. Kufuta akaunti ni kudumu na kunaondoa funguo zako zote za API, historia ya matumizi, na data ya kibinafsi. Unaweza pia kutuma barua pepe kwetu kwa [email protected] kuomba kufutwa chini ya GDPR/haki ya kufutwa.
Je, data yangu iko salama?
Ndiyo. Tunatumia HTTPS kila mahali, bcrypt kwa usimbuaji wa nywila, na kuhifadhi vikao katika Redis kwa tokeni za JWT zenye muda mfupi. Hatuuzi wala kushiriki data yako na watu wengine. Funguo za API zimesimbwa kabla ya kuhifadhiwa. Soma Sera yetu ya Faragha kwa maelezo kamili kuhusu mazoea ya data.
Je, ninaweza kuwa na funguo nyingi za API?
Ndiyo, kulingana na mpango wako: Free (funguo 1), Pro (funguo 5), Business (funguo ∞). Funguo nyingi zinakuruhusu kutenganisha matumizi kwa programu, mazingira (dev/staging/prod), au mwanachama wa timu, na kufuta funguo moja bila kuathiri nyingine.
Nini kitatokea ikiwa funguo yangu ya API itaathiriwa?
Futa mara moja funguo iliyoathiriwa kutoka Dashboard → API Keys na uunde mpya. Kufutwa kunaanza kutumika mara moja — maombi yoyote yanayotumia funguo ya zamani yatakataliwa kwa hitilafu ya 401. Usiingize funguo za API katika udhibiti wa toleo; tumia vigeuzi vya mazingira badala yake.
Je, ni nini dhamana yako ya muda wa upatikanaji?
Tunalenga uptime wa asilimia 99.9 kwa upatikanaji wa API. Wateja wa mpango wa Biashara wanapokea SLA yenye ahadi za uptime. Unaweza kufuatilia hali ya huduma kwa wakati halisi na kihistoria kwenye ukurasa wetu wa Hali, unaoweza kufikiwa kutoka sehemu ya chini ya tovuti hii.
Je, Pexafy inazingatia GDPR?
Ndiyo. Tunakusanya tu data ya chini inayohitajika kuendesha huduma (barua pepe, nywila iliyosimbwa, kumbukumbu za matumizi). Hatuuzi data kwa watu wengine. Unaweza kuomba usafirishaji kamili wa data au kufutwa wakati wowote kutoka Dashboard → Settings au kwa kutuma barua pepe kwa [email protected]. Tazama Sera yetu ya Faragha kwa maelezo kamili.
Hakuna maswali yanayolingana na utafutaji wako. Jaribu neno tofauti.
Tuulize moja kwa mojaBado una maswali?
Hupati unachokitafuta? Timu yetu inafurahi kukusaidia.
Wasiliana na Usaidizi Soma Hati za API