Maswali Yanayoulizwa Mara kwa Mara

Pexafy ni injini ya kutafuta picha inayotumia AI, ambayo inakusanya mamilioni ya picha za bure na za malipo kutoka vyanzo vingi — Unsplash, Pexels, Pixabay, Wikimedia Commons, na zaidi — katika API moja. Badala ya kuunganisha huduma nyingi za picha, unatuma ombi moja kwa Pexafy na kupata matokeo bora kutoka vyanzo vyote, yaliyopangwa kwa umuhimu wa kisemantiki wa AI.

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 1K maombi ya API kwa mwezi.

Ndiyo! Mpango wetu wa Bure unakupa 1K maombi ya API kwa mwezi — bila kuhitaji kadi ya mkopo. Unaweza kutafuta kwa maneno na kupata picha kutoka vyanzo vyote vya bure. Unahitaji maombi zaidi, picha za malipo, au utafutaji wa picha-kwa-picha? Angalia ukurasa wetu wa Bei kwa mipango ya Pro na Business.

Pexafy kwa sasa inakusanya picha kutoka Unsplash, Pexels, Pixabay, Wikimedia Commons, na Openverse. Tunaendelea kuongeza vyanzo zaidi. Unaweza kuchuja matokeo kwa chanzo kwa kutumia kigezo cha source katika API.

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.

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.

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.

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.

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.

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.

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.

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.

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.

Ndiyo, unaweza kupandisha au kushuka daraja wakati wowote kutoka Dashboard → Billing. Upandishaji wa daraja huanza mara moja na bili ya uwiano. Ushukaji wa daraja huanza mwishoni mwa kipindi chako cha sasa cha bili. Kila kitu kinashughulikiwa kiotomatiki kupitia Stripe.

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.

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.

Tunakubali kadi zote kuu za mkopo na za debit (Visa, Mastercard, American Express), pamoja na Apple Pay na Google Pay — zote zinashughulikiwa kwa usalama kupitia Stripe. Hatuhifadhi maelezo yoyote ya malipo kwenye seva zetu.

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.

Ndiyo! Kulipa kwa mwaka hupunguza bei kwa takriban 17%: Pro ni $290/mwaka ($24/mwezi) badala ya $29/mwezi. Business ni $2990/mwaka ($249/mwezi) badala ya $299/mwezi. Badilisha hadi malipo ya kila mwaka kutoka Dashboard → Billing.

Ndiyo! Kama mahitaji yako yanazidi mpango wa Business — 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.

Bei zote zimeonyeshwa kwa USD. Stripe, msindikaji wetu wa malipo, hubadilisha kiotomatiki hadi sarafu yako ya ndani wakati wa malipo. Benki yako inaweza kutoza ada ndogo ya ubadilishaji wa fedha za kigeni kulingana na aina ya kadi yako na nchi yako.

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.

Inategemea leseni ya chanzo. Unsplash, Pexels, na Pixabay zote zinatoa leseni za matumizi ya kibiashara bila malipo kwa picha nyingi zao. Wikimedia Commons na Openverse hutumia leseni mbalimbali za Creative Commons — baadhi zinaruhusu matumizi ya kibiashara, baadhi haziruhusiwi. Daima angalia sehemu ya leseni katika jibu la API na uthibitishe kwenye URL ya chanzo kabla ya kutumia picha kwa madhumuni ya kibiashara.

Picha za premium zinaonekana katika matokeo ya utafutaji lakini zinaweza kuhitaji usajili au ununuzi kwenye chanzo ili kupakua kwa azimio kamili. API inarudisha maono ya awali/picha ndogo kwa picha zote. Katika mipango ya Free na Pro, URL ya chanzo katika jibu itakuambia mahali pa kufikia picha kamili.

Pexafy inarudisha URL za picha zilizohifadhiwa kwenye majukwaa yao ya asili — hatuhudumii faili za picha moja kwa moja kupitia API. Kwa picha za bure (Unsplash, Pexels, Pixabay), unaweza kupakua picha yenye azimio kamili kutoka kwa URL ya chanzo iliyotolewa katika jibu. Daima heshimu masharti ya huduma ya jukwaa la chanzo.

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 zaidi ya picha milioni 5 na inaendelea kukua kila siku.

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.

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.

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.

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.

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.

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.