よくある質問

Pexafyについて知っておきたいことすべて。答えが見つかりませんか?お問い合わせください

はじめに

Pexafyとは何ですか?

Pexafyは、Unsplash、Pexels、Pixabay、Wikimedia Commonsなど複数のソースから数百万点の無料・プレミアム画像を集約し、単一のAPIで提供するAI搭載の画像検索エンジンです。数十もの画像サービスを個別に統合する代わりに、Pexafyへ1回リクエストするだけで、AIによるセマンティック関連性順にランク付けされた全ソースのベスト結果を取得できます。

APIキーを取得するにはどうすればいいですか?

pexafy.com/auth/register/ で無料アカウントを作成し、ダッシュボード → APIキー → キーを作成 に進んでください。最初のキーはクレジットカード不要で即座に発行されます。無料プランには月1K回のAPIリクエストが含まれます。

Pexafyは無料で使えますか?

はい!無料プランでは月1K回のAPIリクエストをご利用いただけます — クレジットカード不要です。テキストベースのクエリで検索し、すべての無料画像ソースにアクセスできます。リクエスト数の追加、プレミアム画像、または画像to画像検索が必要な場合は、料金ページのProプランおよびBusinessプランをご確認ください。

Pexafyはどの画像ソースを検索しますか?

Pexafyは現在、Unsplash、Pexels、Pixabay、Wikimedia Commons、Openverseから画像を集約しています。ソースは継続的に追加中です。APIのsourceパラメーターを使用して、ソースごとに結果をフィルタリングできます。

PexafyはGoogle Imagesと何が違いますか?

Pexafyは一般向け検索エンジンではなく、開発者向けのAPIです。無料利用可能なソースおよびCreative Commonsのソースのみを集約しているため、すべての結果をプロダクトで安全に使用できます。AIモデルはセマンティックな意味を理解するため、「cozy autumn vibes」と検索すればキーワードの単純一致ではなく、関連性の高い画像を取得できます。さらに、構造化されたJSONレスポンス、ページネーション、フィルター、利用状況アナリティクスをすべて単一のREST APIで利用できます。

SDKやクライアントライブラリは提供していますか?

現在、包括的なドキュメントを備えたREST APIを提供しています。Python、JavaScript/TypeScript、PHP向けの公式SDKはロードマップに含まれています。それまでの間、APIはAPIキーヘッダーを含む単一のHTTPSリクエストだけで簡単に統合できます。複数の言語によるコード例はドキュメントをご確認ください。

APIと技術情報

APIのレート制限はどうなっていますか?

レート制限はプランによって異なります:無料 — 20 リクエスト/分、Pro — 60 リクエスト/分、Business — 300 リクエスト/分。制限を超えた場合、再試行可能なタイミングを示すRetry-Afterヘッダーとともに 429 Too Many Requests レスポンスが返されます。

APIはどのような形式でレスポンスを返しますか?

すべてのレスポンスは標準エンベロープ形式のJSONです:{success, data, meta, pagination, error}。各フォトオブジェクトには、id、title、description、urls(thumbnail、small、regular、full、raw)、photographer(name、url)、source、license、dimensions、colors、relevance scoreが含まれます。

ページネーションはどのように処理しますか?

Pexafyはカーソルベースのページネーションを採用しています。各レスポンスには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(最小関連性スコア 0.0〜1.0)。フィルターを組み合わせることで、より精度の高い結果を得られます。

APIリクエストの認証方法を教えてください。

リクエストヘッダーにAPIキーを追加してください:X-Api-Key: pxfy_your_key_here。または、Bearerトークン認証を使用することもできます:Authorization: Bearer <jwt_token>。クライアントサイドのコードにAPIキーを含めないでください。

1回のリクエストで取得できる最大結果数はいくつですか?

per_page パラメータを使用して、1ページあたり最大80件の結果をリクエストできます(デフォルトは20件)。大きな結果セットの場合は、カーソルベースのページネーションを使用して後続のページを取得してください。ページネーションで移動できるページ数の合計に制限はありません。

Pexafy は多言語検索クエリに対応していますか?

はい!当社のモデルは多言語データで学習されているため、英語、フランス語、スペイン語、ドイツ語、ポルトガル語など、さまざまな言語で検索できます。セマンティック理解は英語で最も高い精度を発揮しますが、他の言語の一般的なクエリでも正確な結果が得られます。最大限の精度を求める場合は英語をお勧めします。

請求とプラン

プランを変更できますか?

はい、ダッシュボード → 請求 からいつでもアップグレードまたはダウングレードできます。アップグレードは日割り計算で即時に反映されます。ダウングレードは現在の請求期間の終了時に有効になります。すべての処理は Stripe を通じて自動的に行われます。

クォータを超過するとどうなりますか?

月間の上限に達すると、APIリクエストがブロックされ、詳細なエラーメッセージとともに 429 レスポンスが返されます。APIの使用を継続するには、ダッシュボード → 請求 からより上位のプランにアップグレードしてください。

返金には対応していますか?

すべての有料プランに14日間の返金保証を提供しています。ご登録から14日以内にご満足いただけない場合は、[email protected] までご連絡ください。理由を問わず全額返金いたします。

どのような支払い方法に対応していますか?

主要なクレジットカードおよびデビットカード(Visa、Mastercard、American Express)のほか、Apple Pay および Google Pay に対応しています。すべての決済は Stripe を通じて安全に処理されます。当社のサーバーにお支払い情報を保存することはありません。

長期契約はありますか?

契約も縛りもありません。すべてのプランは月単位です(ご希望の場合は割引価格の年間プランもあります)。ダッシュボード → 請求 からワンクリックでいつでもキャンセルできます。アクセスは現在の請求期間の終了まで継続されます。

年間割引はありますか?

はい!年間払いにすると約17%お得になります。Pro は月額 $29 の代わりに年額 $290(月換算 $24)、Business は月額 $299 の代わりに年額 $2990(月換算 $249)になります。ダッシュボード → 請求 から年間プランに切り替えられます。

カスタムのエンタープライズプランはありますか?

はい!Business プランを超えるニーズ(より高いレート制限、専用インフラ、カスタム SLA、オンプレミス展開など)がある場合は、要件を添えて [email protected] までお問い合わせください。お客様の組織に合わせたプランをご提案いたします。

支払いに対応している通貨は何ですか?

すべての価格は米ドル(USD)で表示されます。決済処理業者の Stripe がチェックアウト時に自動でお客様の現地通貨に換算します。カードの種類やお住まいの国によっては、銀行から少額の外国為替手数料が請求される場合があります。

画像とライセンス

Pexafy は画像を所有していますか?

いいえ。Pexafy は検索エンジンであり、サードパーティのプラットフォーム(Unsplash、Pexels、Pixabay など)にホストされている画像をインデックス化して検索します。実際の画像ファイルを保存、ホスト、再配布することはありません。すべての画像は各フォトグラファーおよびプラットフォームに帰属します。

画像を商用目的で使用できますか?

ソースのライセンスによって異なります。Unsplash、Pexels、Pixabay はいずれもほとんどの画像について無料の商用利用ライセンスを提供しています。Wikimedia Commons と Openverse はさまざまな Creative Commons ライセンスを使用しており、商用利用が可能なものとそうでないものがあります。画像を商用目的で使用する前に、必ず API レスポンスのライセンスフィールドを確認し、ソース URL でライセンスを検証してください。

プレミアム画像は何が違うのですか?

プレミアム画像は検索結果に表示されますが、フル解像度でダウンロードするにはソースサイトでのサブスクリプションまたは購入が必要な場合があります。APIはすべての画像のプレビュー/サムネイルを返します。FreeプランおよびProプランでは、レスポンス内のソースURLからフル画像へアクセスできます。

APIを通じて画像をダウンロードできますか?

Pexafyは、各画像がホストされているオリジナルプラットフォームへのURLを返します。APIを通じて画像ファイルを直接提供することはありません。フリー画像(Unsplash、Pexels、Pixabay)については、レスポンスに含まれるソースURLからフル解像度の画像をダウンロードできます。必ずソースプラットフォームの利用規約を遵守してください。

画像インデックスはどのくらいの頻度で更新されますか?

インデックスパイプラインはすべての主要ソースに対して毎日実行されます。Unsplash、Pexels、Pixabay、その他のプラットフォームに新しくアップロードされた画像は、通常24〜48時間以内にPexafyで検索可能になります。現在のインデックスには500万点以上の画像が含まれており、毎日増え続けています。

アカウントとセキュリティ

アカウントを削除するにはどうすればよいですか?

ダッシュボード → 設定 → 危険ゾーン → アカウントの削除 から操作してください。アカウントの削除は永続的であり、すべてのAPIキー、利用履歴、個人データが削除されます。GDPR/消去権に基づく削除のご依頼は、[email protected] までメールでご連絡いただくこともできます。

データは安全に管理されていますか?

はい。すべての通信にHTTPSを使用し、パスワードのハッシュ化にはbcryptを採用、セッションは短命のJWTトークンとともにRedisで管理しています。お客様のデータを第三者に販売・提供することはありません。APIキーは保存前にハッシュ化されます。データの取り扱いについての詳細は、プライバシーポリシーをご覧ください。

複数のAPIキーを持つことはできますか?

はい。プランによって異なります:Free(1個)、Pro(5個)、Business(∞個)。複数のキーを使用することで、アプリケーション、環境(dev/staging/prod)、またはチームメンバーごとに利用を分離し、他のキーに影響を与えることなく個別のキーを失効させることができます。

APIキーが漏洩した場合はどうすればよいですか?

ダッシュボード → APIキー から漏洩したキーをすぐに失効させ、新しいキーを作成してください。失効は即座に反映され、古いキーを使用したリクエストは401エラーで拒否されます。APIキーはバージョン管理にコミットせず、必ず環境変数を使用してください。

稼働率の保証はありますか?

APIの可用性について、99.9%の稼働率を目標としています。ビジネスプランのお客様には、稼働率に関するコミットメントを含むSLAをご提供します。リアルタイムおよび過去のサービス状態は、本サイトのフッターからアクセスできるステータスページでご確認いただけます。

PexafyはGDPRに準拠していますか?

はい。サービス運営に必要な最小限のデータ(メールアドレス、ハッシュ化されたパスワード、利用ログ)のみを収集しています。データを第三者に販売することはありません。データの完全なエクスポートまたは削除は、ダッシュボード → 設定 から、もしくは [email protected] へのメールにていつでもご依頼いただけます。詳細はプライバシーポリシーをご覧ください。

まだ疑問がありますか?

お探しの情報が見つかりませんか?チームが喜んでお手伝いします。

サポートに問い合わせる APIドキュメントを読む

Pexafyについて ブログ