Ximilar Appをはじめよう：プラン設定とAPIアクセス

Ximilar Appは、画像分析および操作のための視覚的AIプラットフォームへの簡単なアクセスを提供します。事前学習済みモデルを使用する場合でも、独自のモデルを構築する場合でも、プラットフォームは簡単に統合できるように設計されています。SaaS/MLaaS（Software as a Service）の原則に基づいて動作し、GDPRに準拠しています。

このアプリを使用すると、利用可能なソリューションのテスト、ユーザープランの管理、およびトークンを使用したAPIリクエストの認証を行うことができます。このガイドでは、私が登録、プランの設定、認証トークンの取得という最初のステップを順を追ってご説明します。それでは始めましょう！

Ximilar Appの主な機能

Ximilar Appは、4つのコア機能を提供します。

• プラン管理 – プランを設定し、認証APIトークン（APIへのリクエストを認証するために使用される一意の識別子）を取得して、APIクレジットの使用状況を監視します。
• サービスアクセス – ドラッグアンドドロップのフォームを使用してAIモデルをテストするか、事前設定されたAPIリクエストを介してそれらを統合します。各サービスには、正確なリクエストとレスポンスが表示されます。
• モデル開発 – コーディングなしで、Ximilarプラットフォーム上でカスタムコンピュータビジョンモデルをトレーニングしてデプロイします。
• データ管理 – トレーニングデータのアップロードとラベル付けを行い、ビジュアル検索用の画像コレクションを管理します。

Ximilar Appで利用可能なAIソリューション

Ximilar Appは、Ximilar APIを介してすぐに展開できる、AIを活用したさまざまなソリューションを提供します。

認識とタグ付け

AIを活用した検出および分類により、eコマースの商品写真からCCTVの脅威検出に至るまで、さまざまな視覚データの詳細なタグ付けが可能になります。この認識APIは、PNG、WEBP、およびJPEG形式を受け入れます。利用可能なモデルの数は常に増加しており、当社のウェブサイトまたはアプリ内で閲覧できます。

ビジュアル検索

ビジュアル検索は、多言語テキストから画像への検索、商品のおすすめのための類似性検索、逆画像検索、および重複マッチングをカバーしています。テクノロジーの詳細についてはこちらをご覧いただくか、ファッション検索やホームデコレーションのソリューションを直接ご覧ください。

画像ツール

高品質なアップスケーリングのためのGANおよびマルチプライイング・イメージ・アップスケーラーや、一括画像処理のためのAI主導の背景の削除など、画像の強化および操作のためのAIを活用したツールを提供しています。

その他のすぐに使えるAIツール

例えば、OCRや自動化された商品説明などのテキストベースのAIソリューションを提供しています。

コーディングなしでカスタムコンピュータビジョンモデルを構築

また、Ximilar Appを使用すると、コーディングも、機械学習に関する高度な専門知識も必要とせずに、カスタムコンピュータビジョンモデルを作成してデプロイできます。以下のモデルを構築できます。

• カスタム画像の認識とタグ付け – 視覚コンテンツの分類とラベル付け。
• 物体検出 – 画像内の特定の物体を特定。
• 画像回帰 – 年齢、品質評価、その他の数値推定などの値を予測。

これらのモデルは、Ximilar APIを介してシステムに簡単に統合できます。

それでは、アプリの最初のステップを見ていきましょう。

1. Ximilar Appにログインする

当社のAPIを使用するには、まずapp.ximilar.comでログインまたは登録する必要があります。登録は無料であり、支払い情報は必要ありません。メールアドレスを入力し、送信されたメールで登録を確認するだけです。Googleアカウントを使用してサインアップすることもできます。

登録すると、APIリクエストを認証するための一意のAPIトークンが自動的に発行されます。

Ximilar Appにサインイン

2. アプリのナビゲーション

Ximilar Appに入って最初に表示されるのはダッシュボードです。ここには、クレジットの使用状況、すぐにコピーできるトークン、毎週のトラフィックに関するインサイト、およびドキュメントへのリンクが表示されます。これは、新しい機能を探索し、新しく公開されたAPIエンドポイントを見つけるための最も早い方法です。

アプリのナビゲーションは2つのメニューに分かれています。主要なサイドバーは、サービス、プラットフォーム、アノテーション、マイプラン、およびヘルプセンターにリンクしています。お気に入りのサービスを選択すると、メインメニューの上部に固定され、すばやくアクセスできるようになります。

フルテキスト検索を使用してアプリ全体を検索したり、右下のライブチャットからサポートを依頼したりできます。

3. プランを設定する

プランは2つの要素によって決まり、当社の計算ツールはその両方を考慮します。

• 必要なソリューション – 当社のソリューションは、いくつかの複雑さの階層に分かれています。当社のウェブサイト（制限付きデモ経由）およびXimilar Appの両方でそれらを探索およびテストでき、詳細な情報は料金ページおよびAPIドキュメントで確認できます。
• 必要なAPIクレジットの供給量 – 各APIリクエストは、操作に応じて一定数のクレジットを消費します。料金ページで操作とそれぞれのクレジット費用の完全なリスト、およびそれらのドキュメントへのリンクを確認できます。

計算ツールを使用して自動設定を行う

計算ツールは、選択したソリューションと予想される処理量に基づいて、適切なサブスクリプションプランを提案します。以下の手順に従ってください。

1) 計算ツールを開く — Ximilar App内、または料金ページから。

2) ソリューションと操作を選択する – 例えば、AI Recognition of CollectiblesとPricing（トレーディングカードの価格検索）。

3) 推定月間処理量を入力する – 1か月に処理すると予想される画像の数を入力します。ツールは、予想されるAPIクレジット消費量に最適なプランを推奨します。

「Buy now」をクリックすると、アプリ内で推奨されるプラン設定が事前に選択され、チェックアウト前にソリューション、機能、制限、および月間クレジット供給量を確認できます。

例えば、ここでは私がソリューションとしてAI Recognition of Collectiblesを選択し、月に10,000枚の画像（コレクターアイテム）の価格を取得する必要があると見積もりました。計算ツールはBusiness 100Kプランを提案し、推奨プランへの直接リンクをすぐに受け取りました。

プラン設定ページで設定を完了する

どのソリューションとどれくらいのクレジットが必要か既にわかっている場合、または計算ツールがプランを提案した場合は、プラン設定ページに進んでください。そこでは以下のことができます。

• 含まれるソリューション、機能、および制限を確認する。
• チェックアウトに進み、請求先情報を提供し、価格とVATを確認して、Stripe経由で支払いを完了する。

プランの概要を確認する

サブスクリプションの登録後、プランの概要には、プログレスバーとともに私のアカウントステータスが表示され、残りのAPIクレジットが一目でわかります。また、サイドバーの下部にあるタグでもクレジットの消費量を確認できます。私の毎月の供給量は、サブスクリプションの更新日に更新されます。APIクレジットの使用状況は、統計を介して詳細に監視できます。

ヒント：クレジットパックでクレジットの供給量を拡張する

クレジットパックは、大規模な1回限りのバッチ処理に最適です。これらは月間クレジットが使い果たされた後にのみ消費され、有効期限がないため、トラフィックの急増に対する信頼性の高いバッファとなります。

ただし、毎月の安定した使用が予想される場合は、少し高めの月間クレジットプランを選択する方が良い選択肢です。サブスクリプションに含まれるクレジットが多いほど、全体的なコストが低くなり、長期的に見てより効率的な選択となります。プラン設定では、上位のサブスクリプション階層を選択することで節約できる割合を確認できます。

4. APIトークンを確認する

トークンはXimilar APIのキーです。メインダッシュボード、およびすべてのサービスダッシュボードで直接利用でき、ワンクリックでコピーできます。すべてのAPI呼び出しの認証情報であるため、非公開にしてください。必要に応じて、新しいトークンを生成することもできます。

5. API経由で統合する

以下では、Pythonの基本的なコマンドを私からご紹介します。cURLリクエストのヒントについては、記事How to Automate Pricing of Cards & Comics via APIを確認することをお勧めします。

Pythonと必要なライブラリをインストールする

Ximilar APIを使用する前に、Python 3.6以降がインストールされていることを確認してください。一部のシステムにはすでにPythonが含まれていますが、不明な場合は、ターミナル、コマンドプロンプト、またはシェルで次のコマンドを実行して確認できます。

python --version && pip --version

正しい出力は次のようになります。

Python 3.9.18  
pip 23.1 from /Users/yourname/env/devel/lib/python3.9/site-packages/pip (python 3.9)

Pythonがインストールされていない場合は、RealPythonのこちらのチュートリアルに従ってください。Windows、macOS、Linuxのインストール手順が記載されています。Pythonの準備ができたら、pipを使用して必要なライブラリをインストールします。

pip install --upgrade argparse requests

これで、Ximilar APIの操作を開始する準備がすべて整いました。

APIのリクエストとレスポンス

エンドポイント、コマンドの例、Ximilar APIの最初のステップなど、すべてのサービスはAPIドキュメントに詳しく説明されています。クイックスタートガイドから始めることをお勧めします。

Ximilar Appからのリクエスト例の使用

Ximilar Appでサービスをテストする場合、テストページの下部にリクエストがどのように構成されたか（cURL、Python、JavaScriptの場合）と、対応するJSON形式のレスポンスが正確に表示されます。

独自のAPI呼び出しを構築する際に、これらの例を直接参照として使用できます。

例：REST API経由でのトレーディングカードの価格取得

このスクリプトは、トレーディングカードの画像を識別および価格取得のためのAPIに送信します。

import sys
import requests
import pprint

url = "https://api.ximilar.com/collectibles/v2/tcg_id"
headers = {
  "Content-Type": "application/json",
  "Authorization": f"Token {sys.argv[1]}"
}
data = {
  "records": [
    {"_url": sys.argv[2]}
  ],
  "pricing": True
}

response = requests.post(url, headers=headers, json=data)
pprint.pprint(response.json)

仕組み：

• このスクリプトは、APIトークン（sys.argv[1]）とカードの画像URL（sys.argv[2]）という2つのコマンドライン引数を受け取ります。必要に応じて、これらを直接の変数代入に置き換えることができます。
• 画像のURLを含むPOSTリクエストをAPIに送信します。
• "pricing": Trueパラメーターは価格の詳細を要求します。
• カードの詳細と推定価格を含むレスポンスが、pprintを使用して出力されます。

結論

API連携をすべて自分で行いたいわけではない方がいらっしゃることも承知しております。それは全く問題ありません。手間のかからない設定をご希望であれば、プランの設定からソリューションのワークフローへの統合まで、すべて私たちが代行いたします。お気軽にお知らせください。喜んでお手伝いいたします。

途中で何かご質問やお困りごとがあれば、遠慮なくお問い合わせください。また、高度な機能やベストプラクティス、API連携について解説した記事も、私からあわせてご覧になることをおすすめします。