よくある質問

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

はじめに

Pexafyとは何ですか?

Pexafyは、9つのソース(Unsplash, Pexels, Pixabay, Kaboompics, Burstなど)から数百万点の無料利用可能な画像を集約し、単一のAPIとして提供するAI搭載の画像検索エンジンです。Pexafyへの1回のリクエストで、全9ソースにわたるセマンティック検索が実行されます。各プロバイダー独自のAPIで同じ検索を行う場合、3〜5回のAPIコールに加え、マージ処理やJSONの正規化が必要となり、それらはすべてお客様が記述・保守・負担するコードとなります。

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

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

アプリケーションの審査申請は必要ですか?

いいえ。キーは最初の呼び出しからすぐに使用できます。アプリケーションの審査も、待機期間も、ダウンロードのたびに必須のダウンロードトラッキング呼び出しを行う必要もありません。Unsplashは審査前のアプリケーションを50リクエスト/時間に制限しており、Pexelsは200/時間を許可しています。

Pexafyは無料で使えますか?

はい!Freeプランでは毎月5K件のAPIリクエストをご利用いただけます。クレジットカードは不要で、他のプランと同じくPexafyがインデックスするすべてのソースを検索できます。もっとリクエストが必要ですか?StarterからEnterpriseまでの有料プランで上限が上がります。料金ページをご覧ください。

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

Pexafyは現在9つのソースを集約しており、主なものはUnsplash, Pexels, Pixabay, Kaboompics, Burstです。引き続きソースを追加中です。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 は多言語検索クエリに対応していますか?

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

請求とプラン

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

はい、ダッシュボード → 請求 からいつでもプランを変更できます。変更は即時に反映され、当社の販売代理店である Creem が日割りで精算します。上位プランへの変更では現在の期間の残り日数分の差額が請求され、下位プランへの変更ではその差額が返金されます。

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

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

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

すべての有料プランに14日間の返金保証を提供しています。ご登録から14日以内にご満足いただけない場合は、[email protected] までご連絡ください。理由を問わず全額返金いたします。返金は当社の販売代理店である Creem が、お支払いに使用された決済手段に行います。詳しくは返金ポリシーをご覧ください:pexafy.com/legal/refund/

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

お支払いは、当社の販売代理店であり Merchant of Record である Creem が処理します。クレジットカードまたはデビットカードのほか、お住まいの国で Creem が決済時に提供するその他の支払い方法をご利用いただけます。当社がカード情報を閲覧・保存することは一切ありません。

長期契約はありますか?

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

年間割引はありますか?

はい!年間払いにすると最大18%お得になります。Pro は月額 $19 の代わりに年額 $199(月換算 $17)、Business は月額 $249 の代わりに年額 $2599(月換算 $217)になります。ダッシュボード → 請求 から年間プランに切り替えられます。

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

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

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

すべての価格は米ドル(USD)で表示され、当社の販売代理店である Creem が USD で請求します。お住まいの国によっては、決済時に付加価値税などの税金が加算される場合があります。カードが別の通貨の場合は、カード会社が金額を換算し、少額の為替手数料がかかることがあります。

画像とライセンス

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

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

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

ソースのライセンスによって異なります。Unsplash、Pexels、Pixabayはいずれも大部分の画像に商用利用可能な無料ライセンスを提供しており、当社がインデックスしている小規模ソースも同様のモデルに従っています。商用利用の前には、必ずAPIレスポンスのライセンスフィールドを確認し、ソースURLで内容を検証してください。

画像に料金はかかりますか?

いいえ。Pexafyは画像を販売していません。すべての検索結果は無料で使えるライブラリ(Unsplash, Pexels, Pixabay, Kaboompics, Burstなど)から取得され、そのライブラリ自身のライセンスのもとで元のページにリンクしています。プランでお支払いいただくのは検索サービスのみ、つまりAPIリクエスト、レート制限、APIキー、サポートです。画像を使う前に、必ずソースでライセンスをご確認ください。

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

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

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

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

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

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

ダッシュボード → 設定 → 危険ゾーン → アカウントの削除 から操作してください。アカウントの削除は永続的であり、すべての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について ブログ