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

Pexafy یک موتور جستجوی تصویر مبتنی بر هوش مصنوعی است که میلیون‌ها تصویر رایگان و پریمیوم را از منابع مختلف — از جمله Unsplash، Pexels، Pixabay، Wikimedia Commons و بیشتر — در یک API واحد یکپارچه می‌کند. به جای اتصال به ده‌ها سرویس تصویر، تنها یک درخواست به Pexafy ارسال کنید و بهترین نتایج از تمام منابع را، رتبه‌بندی‌شده بر اساس ارتباط معنایی هوش مصنوعی، دریافت نمایید.

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

بله! پلن رایگان ما 1K درخواست API در ماه به شما می‌دهد — بدون نیاز به کارت اعتباری. می‌توانید جستجوهای متن‌محور انجام دهید و به تمام منابع تصویر رایگان دسترسی داشته باشید. به درخواست‌های بیشتر، تصاویر پریمیوم، یا جستجوی تصویر به تصویر نیاز دارید؟ صفحه Pricing ما را برای پلن‌های Pro و Business بررسی کنید.

Pexafy در حال حاضر تصاویر را از Unsplash، Pexels، Pixabay، Wikimedia Commons و Openverse یکپارچه می‌کند. ما به طور مداوم در حال افزودن منابع بیشتری هستیم. می‌توانید نتایج را بر اساس منبع با استفاده از پارامتر 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 تا ۸۰ نتیجه در هر صفحه درخواست کنید (پیش‌فرض ۲۰ است). برای مجموعه نتایج بزرگ، از صفحه‌بندی مبتنی بر مکان‌نما برای دریافت صفحات بعدی استفاده کنید. هیچ محدودیتی برای تعداد کل صفحاتی که می‌توانید از آن‌ها عبور کنید وجود ندارد.

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

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

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

ما برای تمام پلان‌های پولی، ضمانت بازگشت وجه ۱۴ روزه ارائه می‌دهیم. اگر در ۱۴ روز اول اشتراک رضایت نداشتید، با ما از طریق [email protected] تماس بگیرید تا بازپرداخت کامل را بدون هیچ سوالی انجام دهیم.

ما تمام کارت‌های اعتباری و نقدی اصلی (Visa، Mastercard، American Express)، همچنین Apple Pay و Google Pay را می‌پذیریم — همه به‌صورت امن از طریق Stripe پردازش می‌شوند. هیچ اطلاعات پرداختی را در سرورهای خود ذخیره نمی‌کنیم.

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

بله! پرداخت سالانه تقریباً ۱۷٪ صرفه‌جویی ایجاد می‌کند: پلان Pro به قیمت $290/سال ($24/ماه) به‌جای $29/ماه. پلان Business به قیمت $2990/سال ($249/ماه) به‌جای $299/ماه. برای تغییر به پرداخت سالانه، به مسیر داشبورد ← صورت‌حساب مراجعه کنید.

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

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

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

این موضوع به مجوز منبع بستگی دارد. Unsplash، Pexels و Pixabay برای اکثر تصاویر خود مجوز استفاده تجاری رایگان ارائه می‌دهند. Wikimedia Commons و Openverse از مجوزهای Creative Commons مختلفی استفاده می‌کنند — برخی استفاده تجاری را مجاز می‌دانند و برخی نه. همیشه قبل از استفاده تجاری از یک تصویر، فیلد مجوز را در پاسخ API بررسی کنید و در URL منبع تأیید نمایید.

تصاویر پریمیوم در نتایج جستجو نمایش داده می‌شوند، اما ممکن است برای دانلود با کیفیت کامل به اشتراک یا خرید از منبع اصلی نیاز باشد. API برای همه تصاویر پیش‌نمایش/تصویر بندانگشتی بازمی‌گرداند. در پلن‌های Free و Pro، آدرس منبع در پاسخ API مشخص می‌کند که تصویر کامل را از کجا می‌توانید دریافت کنید.

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

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

به 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] درخواست خروجی کامل داده یا حذف آن را داشته باشید. برای جزئیات کامل، سیاست حریم خصوصی ما را مطالعه کنید.