پرسش‌های پرتکرار

Pexafy یک موتور جستجوی تصویر مبتنی بر هوش مصنوعی است که میلیون‌ها تصویر رایگان را از 9 منبع — Unsplash, Pexels, Pixabay, Kaboompics, Burst و بیشتر — در یک API واحد گردآوری می‌کند. یک درخواست Pexafy = یک جستجوی معنایی در تمام 9 منبع. با APIهای اختصاصی ارائه‌دهندگان، همین جستجو به ۳ تا ۵ فراخوانی نیاز دارد، به علاوه منطق ادغام و نرمال‌سازی JSON: کدی که خودتان می‌نویسید، نگهداری می‌کنید و برایش هزینه می‌پردازید.

یک حساب رایگان در pexafy.com/auth/register/ ایجاد کنید، سپس به Dashboard → API Keys → Create Key بروید. اولین کلید شما بلافاصله و بدون نیاز به کارت اعتباری ساخته می‌شود. پلن رایگان شامل 5K درخواست API در ماه است.

خیر. کلید شما از همان اولین فراخوانی کار می‌کند: بدون بررسی درخواست، بدون دوره انتظار، و بدون نیاز به فراخوانی اجباری ردیابی دانلود برای هر بارگیری. Unsplash برای برنامه‌های تأییدنشده محدودیت 50 درخواست در ساعت را اعمال می‌کند تا زمانی که برنامه شما بررسی شود؛ Pexels نیز 200 درخواست در ساعت را مجاز می‌داند.

بله! پلان Free ماهانه 5K درخواست API به شما می‌دهد — بدون نیاز به کارت اعتباری — و مانند همه‌ی پلان‌های دیگر، در تمام منابعی که Pexafy ایندکس می‌کند جستجو می‌کند. درخواست بیشتری لازم دارید؟ پلان‌های پولی، از Starter تا Enterprise، سقف‌ها را بالا می‌برند: صفحه‌ی قیمت‌ها را ببینید.

Pexafy در حال حاضر 9 منبع را تجمیع می‌کند که بزرگ‌ترین آن‌ها Unsplash, Pexels, Pixabay, Kaboompics, Burst هستند. ما به‌طور مداوم منابع جدیدی اضافه می‌کنیم. می‌توانید نتایج را بر اساس منبع با استفاده از پارامتر source در API فیلتر کنید.

Pexafy یک API توسعه‌دهنده‌محور است، نه یک موتور جستجوی مصرف‌کننده. ما فقط منابع رایگان و Creative Commons را یکپارچه می‌کنیم، بنابراین هر نتیجه‌ای برای استفاده در محصول شما مجاز است. مدل هوش مصنوعی ما معنای معنایی را درک می‌کند — عبارت «حال‌وهوای دنج پاییزی» را جستجو کنید و تصاویر مرتبط دریافت کنید، نه فقط تطابق کلمات کلیدی. علاوه بر این، پاسخ‌های JSON ساختاریافته، صفحه‌بندی، فیلترها و تحلیل‌های مصرف — همه از طریق یک REST API واحد — در اختیار شما قرار می‌گیرد.

در حال حاضر یک REST API با مستندات جامع ارائه می‌دهیم. SDK های رسمی برای Python، JavaScript/TypeScript و PHP در نقشه راه ما قرار دارند. در این میان، یکپارچه‌سازی API بسیار ساده است — تنها یک درخواست HTTPS با هدر کلید API. برای مشاهده نمونه کدها به چند زبان مختلف، مستندات ما را بررسی کنید.

محدودیت‌های نرخ بسته به پلن شما متفاوت است: رایگان — 20 درخواست در دقیقه، Pro — 60 درخواست در دقیقه، Business — 300 درخواست در دقیقه. در صورت تجاوز از محدودیت، پاسخ 429 Too Many Requests به همراه هدر Retry-After دریافت خواهید کرد که زمان امکان تلاش مجدد را نشان می‌دهد.

تمام پاسخ‌ها به صورت JSON با یک پوشش استاندارد هستند: {success, data, meta, pagination, error}. هر شیء عکس شامل موارد زیر است: id، title، description، urls (thumbnail، small، regular، full، raw)، photographer (name، url)، source، license، dimensions، colors و امتیاز ارتباط.

Pexafy از صفحه‌بندی مبتنی بر cursor استفاده می‌کند. هر پاسخ شامل مقدار pagination.next_cursor است. این مقدار را به عنوان پارامتر cursor در درخواست بعدی خود ارسال کنید تا صفحه بعد را دریافت نمایید. وقتی next_cursor برابر null باشد، به انتها رسیده‌اید.

بله! می‌توانید بر اساس موارد زیر فیلتر کنید: color_name (red، blue، green و...)، color_hex (مثلاً #FF5733 با color_tolerance اختیاری)، orientation (landscape، portrait، square)، source (unsplash، pexels، pixabay و...) و score_threshold (حداقل ارتباط ۰.۰ تا ۱.۰). فیلترها را برای نتایج دقیق‌تر ترکیب کنید.

کلید API خود را به عنوان هدر درخواست اضافه کنید: X-Api-Key: pxfy_your_key_here. همچنین می‌توانید از احراز هویت Bearer token استفاده کنید: Authorization: Bearer <jwt_token>. هرگز کلید API خود را در کد سمت کلاینت به اشتراک نگذارید.

می‌توانید با استفاده از پارامتر per_page تا ۸۰ نتیجه در هر صفحه درخواست کنید (پیش‌فرض ۲۰ است). برای مجموعه نتایج بزرگ، از صفحه‌بندی مبتنی بر مکان‌نما برای دریافت صفحات بعدی استفاده کنید. هیچ محدودیتی برای تعداد کل صفحاتی که می‌توانید از آن‌ها عبور کنید وجود ندارد.

بله! مدل ما بر روی داده‌های چندزبانه آموزش دیده است، بنابراین می‌توانید به انگلیسی، فرانسوی، اسپانیایی، آلمانی، پرتغالی و بسیاری از زبان‌های دیگر جستجو کنید. درک معنایی در زبان انگلیسی بهترین عملکرد را دارد، اما بیشتر جستجوهای رایج در سایر زبان‌ها نتایج دقیقی ارائه می‌دهند. برای حداکثر دقت، استفاده از زبان انگلیسی را توصیه می‌کنیم.

بله، هر زمان از داشبورد ← صورت‌حساب پلان خود را تغییر دهید. تغییر بلافاصله اعمال می‌شود و Creem، فروشنده‌ی مجاز ما، آن را به نسبت محاسبه می‌کند: انتقال به پلان بالاتر، اختلاف قیمت برای باقی‌مانده‌ی دوره‌ی فعلی را دریافت می‌کند و انتقال به پلان پایین‌تر آن را بازمی‌گرداند.

پس از رسیدن به محدودیت ماهانه، درخواست‌های API مسدود می‌شوند — پاسخ ۴۲۹ همراه با پیام خطای توضیحی دریافت خواهید کرد. برای ادامه استفاده از API، از مسیر داشبورد ← صورت‌حساب به پلان بالاتری ارتقا دهید.

ما برای تمام پلان‌های پولی، ضمانت بازگشت وجه ۱۴ روزه ارائه می‌دهیم. اگر در ۱۴ روز اول اشتراک رضایت نداشتید، با ما از طریق [email protected] تماس بگیرید تا بازپرداخت کامل را بدون هیچ سوالی انجام دهیم. Creem، فروشنده‌ی مجاز ما، مبلغ را به روش پرداخت اصلی شما بازمی‌گرداند. جزئیات در سیاست بازپرداخت ما: pexafy.com/legal/refund/

پرداخت‌ها توسط Creem، فروشنده‌ی مجاز و Merchant of Record ما، پردازش می‌شوند. می‌توانید با کارت اعتباری یا نقدی، یا با دیگر روش‌های پرداختی که Creem هنگام پرداخت در کشور شما ارائه می‌دهد، پرداخت کنید. ما هرگز اطلاعات کارت شما را نمی‌بینیم و ذخیره نمی‌کنیم.

بدون قرارداد، بدون تعهد. تمام پلان‌ها ماه‌به‌ماه هستند (یا با تخفیف سالانه در صورت انتخاب). در هر زمانی با یک کلیک از مسیر داشبورد ← صورت‌حساب لغو کنید. دسترسی شما تا پایان دوره صورت‌حساب جاری ادامه خواهد داشت.

بله! پرداخت سالانه تا 18٪ صرفه‌جویی ایجاد می‌کند: پلان Pro به قیمت $199/سال ($17/ماه) به‌جای $19/ماه. پلان Business به قیمت $2599/سال ($217/ماه) به‌جای $249/ماه. برای تغییر به پرداخت سالانه، به مسیر داشبورد ← صورت‌حساب مراجعه کنید.

بله! اگر نیازهای شما از پلان Enterprise فراتر می‌رود — محدودیت‌های نرخ بالاتر، زیرساخت اختصاصی، SLA سفارشی، یا استقرار درون‌سازمانی — با ذکر نیازمندی‌هایتان با ما از طریق [email protected] تماس بگیرید. ما یک پلان سفارشی متناسب با سازمان شما تهیه خواهیم کرد.

همه‌ی قیمت‌ها به دلار آمریکا (USD) اعلام شده‌اند و Creem، فروشنده‌ی مجاز ما، آن‌ها را به USD دریافت می‌کند. بسته به کشور شما ممکن است مالیاتی مانند مالیات بر ارزش افزوده هنگام پرداخت اضافه شود. اگر کارت شما به ارز دیگری است، بانک شما مبلغ را تبدیل می‌کند و ممکن است کارمزد کوچکی برای تبدیل ارز دریافت کند.

خیر. Pexafy یک موتور جستجو است — ما تصاویر میزبانی‌شده در پلتفرم‌های شخص ثالث (Unsplash، Pexels، Pixabay و غیره) را ایندکس و جستجو می‌کنیم. فایل‌های واقعی تصاویر را ذخیره، میزبانی یا توزیع مجدد نمی‌کنیم. تمام تصاویر متعلق به عکاسان و پلتفرم‌های مربوطه خود باقی می‌مانند.

بستگی به مجوز منبع دارد. Unsplash، Pexels و Pixabay برای اکثر تصاویرشان مجوز استفاده تجاری رایگان ارائه می‌دهند، و منابع کوچک‌تری که ایندکس می‌کنیم نیز از همین مدل پیروی می‌کنند. همیشه فیلد license در پاسخ API را بررسی کنید و پیش از استفاده تجاری از یک تصویر، مجوز را در URL منبع تأیید نمایید.

خیر. Pexafy تصویر نمی‌فروشد. هر نتیجه از یک کتابخانه‌ی رایگان — Unsplash, Pexels, Pixabay, Kaboompics, Burst و دیگران — می‌آید و به همان‌جا پیوند می‌دهد، تحت مجوز خود آن کتابخانه. پلان شما فقط هزینه‌ی سرویس جستجو را می‌پردازد: درخواست‌های API، محدودیت نرخ، کلیدهای API و پشتیبانی. پیش از استفاده، مجوز هر تصویر را در منبع آن بررسی کنید.

Pexafy آدرس تصاویر میزبانی‌شده در پلتفرم‌های اصلی آن‌ها را بازمی‌گرداند — ما فایل‌های تصویر را مستقیماً از طریق API ارائه نمی‌دهیم. می‌توانید تصویر با کیفیت کامل را از آدرس منبع موجود در پاسخ دانلود کنید. همواره شرایط استفاده از سرویس پلتفرم منبع را رعایت کنید.

خط لوله ایندکس‌گذاری ما برای تمام منابع اصلی به‌صورت روزانه اجرا می‌شود. تصاویر جدید آپلودشده در Unsplash، Pexels، Pixabay و سایر پلتفرم‌ها معمولاً ظرف ۲۴ تا ۴۸ ساعت از طریق Pexafy قابل جستجو هستند. فهرست ما در حال حاضر 9M+ تصویر دارد و هر روز در حال رشد است.

به Dashboard → Settings → Danger Zone → Delete Account بروید. حذف حساب دائمی است و تمام کلیدهای API، تاریخچه استفاده و اطلاعات شخصی شما را پاک می‌کند. همچنین می‌توانید از طریق ایمیل [email protected] درخواست حذف اطلاعات خود را بر اساس GDPR/حق پاک‌سازی داده ارسال کنید.

بله. ما از HTTPS در همه جا، bcrypt برای هش کردن رمز عبور و ذخیره نشست‌ها در Redis با توکن‌های JWT کوتاه‌مدت استفاده می‌کنیم. اطلاعات شما را به اشخاص ثالث نمی‌فروشیم یا به اشتراک نمی‌گذاریم. کلیدهای API پیش از ذخیره‌سازی هش می‌شوند. برای جزئیات کامل درباره شیوه‌های مدیریت داده، سیاست حریم خصوصی ما را مطالعه کنید.

بله، بسته به پلن شما: Free (1 کلید)، Pro (5 کلید)، Business (∞ کلید). داشتن چند کلید به شما امکان می‌دهد مصرف را بر اساس اپلیکیشن، محیط (dev/staging/prod) یا عضو تیم جداسازی کنید و هر کلید را بدون تأثیر بر سایرین لغو کنید.

بلافاصله کلید در معرض خطر را از Dashboard → API Keys لغو کنید و یک کلید جدید بسازید. لغو کلید فوری است — هر درخواستی با کلید قدیمی با خطای 401 رد می‌شود. هیچ‌گاه کلیدهای API را در سیستم کنترل نسخه ذخیره نکنید؛ به‌جای آن از متغیرهای محیطی استفاده کنید.

ما هدف‌گذاری کرده‌ایم تا ۹۹.۹ درصد زمان در دسترس بودن API را تضمین کنیم. مشتریان طرح Business یک SLA با تعهدات زمان آپتایم دریافت می‌کنند. می‌توانید وضعیت سرویس را به‌صورت لحظه‌ای و تاریخچه‌ای در صفحه وضعیت ما، که از پاورقی این سایت قابل دسترسی است، رصد کنید.

بله. ما فقط حداقل داده‌های لازم برای ارائه سرویس (ایمیل، رمز عبور هش‌شده، لاگ‌های استفاده) را جمع‌آوری می‌کنیم. اطلاعات را به اشخاص ثالث نمی‌فروشیم. می‌توانید در هر زمان از Dashboard → Settings یا با ارسال ایمیل به [email protected] درخواست خروجی کامل داده یا حذف آن را داشته باشید. برای جزئیات کامل، سیاست حریم خصوصی ما را مطالعه کنید.