Velox TriFit: Virtual Try-On API

Velox Developer Hub — DressMe & TriFit

ウェブサイト、アプリ、または小売プラットフォームにバーチャル試着を組み込みましょう。DressMe は、買い物客の写真と衣服の画像から、AI によるコーディネートプレビューを作成します。TriFit は Velox のコンシューマー向けエクスペリエンスです。

このリポジトリは、Velox SDK のソース、実行可能なインテグレーション、チュートリアル、AI エージェント向けインテグレーションスキルを公開する場所です。まずデモを試してから、その背後にある SDK の実装を確認してください。

まずはこちら

内容	移動先
アカウントなしで試す	ホスト型デモ — 無料の共有デモ。キューには制限があります
自分の保存済み写真、商品、履歴を使って試す	TriFit アプリ — サインイン／アカウントを作成し、利用可能な無料の日次・週次・月次枠を使用します
デモのリクエストを確認し、SDK ZIP をダウンロードする	デモダッシュボードと SDK
認証情報なしで、すぐに自分のコンピューターで試す	このリポジトリをダウンロードし、Node.js 22 以降で npm run preview を実行します
実際のインテグレーションを構築する	はじめに · アクセスを申請
既存の TriFit アカウントを使い、パートナーキーなしでコードから DressMe を実行する	例 2：アカウントでサインイン
どのアクセス方法を選ぶべきか確認する	DressMe のすべての利用方法
API のフローを読む	技術解説
SDK を選ぶ	SDK カタログ
Codex または GitHub Copilot を使ってウェブ／モバイル連携を構築する	MCP のセットアップとモバイル用スタータープロンプト · ポータブルなインテグレーションスキル
公開済みの OpenAI Developer プラグインをインストールする	Velox TriFit Developer — 読み取り専用の API ガイダンス
現在の MCP サーバーに接続する	Velox TriFit MCP — プロトコルのエンドポイントです。クライアントのセットアップとツールの制限
公式レジストリで現在の MCP サーバーを探す	Velox TriFit レジストリの掲載ページ · 公開記録
公開 API の概要を確認する	Velox TriFit Partner API

公開ページは 2 つです。Velox オペレーター用の管理画面ではありません。 ダッシュボードに表示されるのは、訪問者自身のブラウザーセッションからのリクエストと、公開 SDK のダウンロードのみです。キー、ルーティング、クォータの編集、他の訪問者の写真、トラフィックテストの制御機能はありません。ホスト型 UI の更新には、Studio の Development から Production へのリリースゲートが適用されます。公開ホストでは、確認しているソースより前の承認済みバージョンが稼働している場合があります。

実際の公開バーチャル試着例を見る

既存の公式 TriFit の例：AI パーソナルポートレート、衣服の参照画像、実際の TriFit 出力です。これらは過去の例であり、モック、新たに実施したテスト、パフォーマンスや品質の比較ではありません。出典とメディアに関する注記。

例	個人写真	衣服の参照画像	TriFit の結果
Amara · アクティブウェア
Mateo · オーバーシャツ

利用可能なアカウントの利用枠でTriFit アプリを使って自分の写真を試すか、アカウント不要の共有デモをお試しください。稼働中のホストには、個別のリリースを通じて UI の更新が反映されます。

コーディネートコラージュのスターター商品

デモのソースには、プロバイダー比較テストで使用したものと同じ5点の衣服コラージュが、画像を編集せずに収録されています。ボード全体を商品の参照画像として選び、別の個人写真を使用してください。ボード内の参照モデルは、試着対象の人物ではありません。アクセサリーの反映や衣服の再現度は異なる場合があります。

グリーンのトレンチ · ディテール	グリーンのトレンチ · 全身コーディネート	バーガンディのトレンチとスカート

ネイビーのブレザーとアーガイル柄のスカート	レザージャケットとデニム

これらは商品入力であり、生成結果の画像でも、プロバイダーのランキングを示す証拠でもありません。上記のAmara／Mateoの対応例とは別のものです。ボード内のブランド名は、推奨を意味するものではありません。

Codex プラグインをインストールする

Velox TriFit Developer の OpenAI 掲載ページは公開済みです（2026年10月24日確認、バージョン1.1.2）。フルプラグインをインストールせずに、Codex または Copilotで公開ドキュメントの MCP に直接接続することもできます。どちらの方法でも、稼働中の Partner API へのアクセス権は付与されません。公式 MCP レジストリの掲載ページにある io.github.Velox-XR/velox-trifit-developer バージョン 2.0.0 は、2026年10月24日に独立して確認され、有効で最新でした。掲載ページは現在の接続先 https://studio.v3lox.com/partner/trifit/mcp を示しています。これは同じ識別子で公開された初期の1.1.0レガシーエンドポイントを置き換えるもので、2つ目の掲載ではありません。GitHub のキュレーション対象レジストリへの登録手続きは保留中です。掲載リクエストは提出済みですが、承認されていません。公開記録と更新チェックリストをご覧ください。レジストリへの掲載によって、検索順位やエージェントによる自動推薦が保証されるわけではありません。

インストール方法とテスト用プロンプトをご覧ください。GitHub マーケットプレイスのパッケージは、ユニバーサルディレクトリの審査・承認とは別です。

Velox TriFit — API ガイダンスと試着を1つのプラグインで

Velox TriFit ChatGPT/Codex プラグインは、API ガイダンスと、同意を得たアカウントまたはゲストでの試着を1つのパッケージにまとめています。v1.2.1 Production 対応ソースと、再現可能な ZIP ビルダーを確認できます。現在の Production エンドポイントにある18個のツールと、匿名で利用できる4つのドキュメント呼び出しは、2026年10月24日に検証済みです。この確認は、認証済みの試着やクライアントによる受け入れ、または公開ディレクトリへの登録承認を証明するものではありません。このリポジトリでは Production パッケージのみを配布しています。非公開の Development パッケージと接続手順は含まれていません。既存の開発者向けパッケージと OpenAI による審査内容に変更はありません。

候補版には、チャットから離れずにメールで申請する方法も含まれています。接続済みの送信者メールボックスを確認し、必要に応じてプロジェクトの詳細を追加した後、[email protected] 宛てのメッセージを確認して承認します。キーは自動発行されません。このメールボックスのワークフローは、承認済みのエンドツーエンドの送信・受信受け入れテストがまだ必要です。

1つのデモ、確認可能な1つの SDK 連携

ホストアプリケーションは、このリポジトリのブラウザー UI、デモバックエンド、共有キューを使用し、JavaScript SDKを利用しています。パートナー専用の別アプリケーションでも、実際の生成であるかのように見せたモックでもありません。

• 専用のホスト型パートナー ID：demo。
• DressMe リクエストは実際に処理されます。AnimateMe は公開デモでは有効になっていません。
• 署名付きで永続化される Webhook 完了通知と、コールバックがない場合の遅延 GET のみの復旧。UI には実際の完了通知元が表示されます。
• 合計経過時間、アップロード、デモキュー、送信から完了の確認までにかかった時間を計測します。これらは GPU のみの処理時間ではありません。
• 1つのルック、または最新の完了済みリクエスト25件すべてを、アップロードした入力、結果、処理時間・チェックサムのマニフェストを含むアセット ZIP としてダウンロードできます。これは SDK ソースの ZIP とは別です。
• 同時に実行できる生成は1件で、各開始の間隔は最低10秒です。
• 個人用と商品用のアップロードは並行して行われ、両方のアセットについて永続化された受領記録が保存されます。 これにより、生成品質を変えたり、キューや使用制限を回避したりせずに、アップロードを順番に待つ時間をなくします。
• ダッシュボードの ZIP には、同じ公開ソース、SDK、サンプル、ガイドが含まれています。
• Velox がホストするデモの利用に API キーは不要です。
• 独自の商用パートナーバックエンドを実行するには、独自のパートナー設定を申請してください。
• パートナーキーを使わず、ご自身の TriFit アカウントを使用するコードには、Example 2を使用してください。

チェックイン済みの設定テンプレートには、demo 連携と Production API URL が記載されていますが、キーは意図的に無効化されており、実際の生成は無効になっています。**これは公開 API 認証情報ではありません。**ホストサービスは、実際のキーを Velox のサーバー上で非公開に読み込みます。キーが GitHub、ブラウザーに送信される JavaScript、公開 ZIP ダウンロードに含まれることはありません。

ローカルで実行する

Node.js 22 以降をインストールしてください。依存関係のインストールは不要です。

npm run preview

表示された URL を開いてください。デモとダッシュボードはローカルで動作します。プレビューではアップロードや生成はできません。ダッシュボードの ZIP ダウンロードはプレビューでも動作します。

リファレンスワークスペースを確認する

公開ワークスペースでは、開発者向けサイドバーから公開コード、SDK ZIP、ウォークスルー、アクセス申請フォームにリンクする、より充実したパートナーデモのレイアウトを採用しています。

• 買い物客の写真を最大 8 枚、商品画像を最大 8 枚、ローカルトレイに追加できます。ソースには、比較テストで使われた初期設定のコーディネートコラージュも 5 枚含まれています。いずれかをクリックすると、アップロードせずに商品トレイへ追加できます。ペアを選択して、リクエストを送信する前に確認できます。プレビューの追加、選択、削除では、アップロードも生成も行われません。
• JPEG、PNG、WebP の写真はブラウザー内でローカルに処理されます。最長辺が 2048 ピクセル以下になるよう自動的にリサイズされ（拡大はされません）、アスペクト比とブラウザーがデコードした向きは維持されます。元のファイルには変更を加えず、処理済みのコピーのみを送信します。画像の選択中や処理中にアップロードは行われません。出力は API の上限である 5 MiB 以内に収まります。ブラウザーの安全性を確保するため、サイズが 32 MiB を超えるファイル、または 1 億ピクセルを超えるファイルは、目立つエラーを表示して拒否されます。サポートされていないファイルや破損したファイルにも、わかりやすいエラーが表示されます。
• 選択したペアが送信されるのは、明示的に同意して送信した場合のみです。このサンプルでは、新しいリクエストごとにペアをアップロードします。トレイは永続的なアセット ID のカタログでも、共有パートナーライブラリでもありません。
• リクエストの各段階、元の入力、完了した結果、買い物客と結果の並べて表示した比較を確認できます。ローカル入力は、開いているページのメモリー内にのみ保持されます。ページの再読み込み後に確認できるのは、リクエスト履歴と利用可能な結果であり、以前の入力は確認できません。
• 履歴には、この署名済みブラウザーセッションにおける最新の 25 件のリクエストのみが表示されます。履歴の更新や、不確かなリクエストの確認は読み取り専用で、ジョブを再実行することはありません。

この公開 UI では、本番／開発の切り替え、共有写真ライブラリ、ルーティング、Webhook 登録、負荷テスト用の操作は公開していません。非公開のパートナーワークベンチに変更はありません。

実際の Partner API アクセスを利用するには、次の手順に従ってください。

1. 更新されたプラグインで、連携済みメールボックスから申請するか、ウェブサイトのフォームを利用してください。チャット内でのプロジェクト、想定される利用方法、ローンチ時期の詳細は任意です。
2. Velox が申請を確認し、一意のパートナー連携を作成して、環境ごとの非公開設定をメールで送信します。
3. 提供された partner.config.json を package.json と同じ場所に保存します。
4. npm start を実行します。起動時に、割り当てられた API ID と環境が検証されます。

Webhook を優先して完了するには、独自のバックエンドキーに webhooks:write を付与するよう Velox に依頼し、公開 HTTPS レシーバーを登録してください。

node setup-webhook.mjs https://YOUR_HTTPS_HOST/webhooks/dressme
npm start

セットアップコマンドは、エンドポイント ID と署名シークレットを partner.config.json に非公開で保存します。ホスティング側のマウントプレフィックスをコールバック URL に含める必要があります。正確なオリジン／プロキシの仕様については、ホスティングを参照してください。Webhook が設定されていない場合、ローカルのサンプルは明示的にポーリングのみで動作し、Webhook による配信をうたうことはありません。スタンドアロンのモックは、引き続き無償の API フロー用フィクスチャです。

無料の TriFit アカウントはパートナー認証情報ではありませんが、独自に利用できる枠を使って、別個の個人アカウント用サンプルを認証できます。実際の Partner API の利用には、Development 環境を含め、料金が発生する場合があります。非公開設定をコミットしたり、Velox がホストするデモキーを別のデプロイで再利用したりしないでください。

利用可能な SDK

JavaScript（Node.js）＋ TypeScript 宣言ファイルは、MIT ライセンスで現在利用できます：SDK ソース · SDK リファレンス。

実行可能なデモは、この SDK を完全に統合したサンプルです。言語パッケージ、フレームワークのサンプル、エージェント向けガイドは、このハブに追加できます。カタログには、実際に存在する実装のみを掲載しています。他の言語では、ドキュメントに記載された HTTP API を利用できますが、提供され、テストが完了するまでは、ダウンロード可能な SDK として案内されません。

キュー、プライバシー、安全な復旧

10 秒の間隔は、最低開始間隔であり、完了予定時刻やパフォーマンスの保証ではありません。 ジョブに時間がかかる場合、完了するまでアクティブ枠を保持します。訪問者ごとに保留中のリクエストは 1 件まで、バックログは 25 件までとすることで、一時的な受付を制限しています。この例では、リクエストの生涯上限は設けていません。Velox API のクォータと商用利用の許可は引き続き適用されます。 新たに作成されたホスト型パートナーには現在、デフォルトの月 100 件の利用枠が設定されています。このリポジトリがその枠を暗黙に増やすことはありません。

ブラウザーセッションはプライベートで、署名済みかつ HttpOnly です。HTTPS では Secure Cookie を使用します。 ダッシュボードはセッション単位です。Cookie を消去すると、そのセッションの履歴にアクセスできなくなります。 Cookie の有効期限が 48 時間であっても、メディアが自動削除されるわけではありません。画像への同意、プライバシーポリシー、合意済みの保持期間が適用されます。

ローカル評価ツールは、無視対象の .demo-state/ にレシートを保存し、排他的な所有者を 1 つだけ設けます。入力 ID、冪等性キー、ジョブ ID は保存しますが、画像データ、API キー、署名付き URL は保存しません。送信結果が不確かな場合、キューは一時停止し、自動的に再送されることはありません。クラッシュ後は、運用担当者による照合のため、ジャーナルとロックを保持してください。共有デモ認証情報を使用して複数のコピーを実行しないでください。

ホスティングとリリースの要件およびセキュリティを参照してください。 キューのレート制限だけでは、費用の予算管理や完全なボット対策にはなりません。

有料 API 呼び出しなしでテストする

npm test
npm run demo:mock
npm run demo:failure

テストと明示的なモックモードでは、ローカルのフィクスチャのみを使用します。プライベート設定を読み込んだり、Velox を呼び出したりすることはありません。モック結果は、実際の AI の結果でも、レイテンシーの証明でもありません。

ライセンス

このリポジトリの公開 SDK、サンプル、ドキュメント、エージェントスキルはMIT ライセンスで提供されています。このライセンスは、Velox のホスト型 API サービス、非公開の製品コード、商標、顧客の資料には適用されません。API へのアクセスと利用には、別途合意された条件が引き続き適用されます。AI によるプレビューは、フィット感、サイズ、色、衣服の細部を保証するものではありません。