プラットフォーム機能ガイド

本ページでは、日常的な利用順に沿って LocoPal Ai の主な機能を紹介します。ログイン後は、現在のアカウントのキー、タスク、素材、請求のみが表示されます。

ホームとモデルマーケット

ホームと上部の製品入口から、コンソール、使用マニュアル、モデルマーケット、LocoPal Creation にアクセスできます。モデルマーケットでは、モデル名、機能、パラメータ、課金の詳細を一元的に確認できます。

モデルを選択する際は、次の順に確認します：

1. モデルの機能と業務タイプが一致していること。例えば動画タスクでは動画モデルを選択します；
2. モデル ID が現在の API Key の /v1/models レスポンスに含まれていること；
3. リクエストパラメータがモデル詳細に表示されるサポート範囲内であること；
4. 予想価格が予算内であること（最終的には実際の請求を基準とします）。

コンソールの概要

コンソールでは、残高、プラン、呼び出し量、消費の推移、最近の記録を確認できます。統計データは高消費のモデルや異常なピークの特定に使用し、請求の明細は最終的な費用の照合に使用します。

API キー

API Key は、モデル、画像、動画、音声、素材の各インターフェースを呼び出すための唯一の資格情報であり、同じ Key をすべてのインターフェースで共通して使用できます。「本番サービス」「テスト環境」「顧客アプリケーション」ごとに個別に作成し、明確な名前、クォータ、有効期限を設定することをおすすめします。

Key を削除または無効化しても、そのアカウントの素材、タスク、履歴記録は削除されません。Key を再作成した後も、元の素材を引き続き使用できます。

使用ログとタスクログ

使用ログは同期呼び出しを記録し、時間、API Key、モデル、グループ、リクエスト識別子、ステータスでフィルタできます。タスクログは動画、音声などの非同期業務に使用します。タスク作成後はタスク ID を保存してください。待ち時間が変化しても再課金されることはなく、タスクを再作成した場合にのみ新しいタスク識別子が発生します。

タスクログには、送信時刻、タスク ID（上流のタスク番号を含む）、所要時間、ステータス、進捗、詳細が表示されます。タスク成功後は「詳細」列に「動画をプレビュー」が表示され、クリックするとポップアップ内で生成された動画を直接再生できます。ポップアップ内で再生アドレスをコピーできるため、ダウンロードしてから確認する必要はありません。管理者がタスクログで他のアカウントのタスクを確認する場合も同様に直接プレビューできます。

ログには現在のアカウント自身の記録のみが表示されます。

素材ライブラリ管理

素材ライブラリは素材グループの集合であり、バーチャル人物と実写人物素材の 2 つのカテゴリを提供します。

バーチャル人物

1. 「新規グループ」をクリックし、「バーチャル人像」を選択して、グループ名と説明を入力します（名前と説明はどちらも空欄にできます。空欄の場合、プラットフォームが自動的に命名します。例えば「バーチャル人像素材 09-11 21:05」）；
2. グループ内で「画像をアップロード」をクリックしてローカル画像を直接選択するか、「素材を送信」で公開アクセス可能な http(s) 画像アドレスを入力します；
3. 素材の送信は非同期処理です。ステータスが「利用可能」と表示された後、素材参照をサポートするモデルで安定して使用できます；
4. 素材の名前変更、ステータスの更新、削除をサポートします。グループを削除する前に、グループ内の素材を移動するか削除する必要があります。

素材を送信する際、「素材名」も空欄にできます。プラットフォームはアップロードしたファイルのファイル名で命名します。名前を変更する必要がある場合は、素材一覧で名前を変更してください。

実写人物素材

実写人物素材は、必ず本人がスマートフォン側で収集と許諾を完了する必要があります：

1. 「新規グループ」をクリックし、「実写人物素材ライブラリ」を選択します；
2. 許諾契約を読み、チェックを入れて QR コードを生成します；
3. 実写人物本人がスマートフォンでスキャンし、収集、許諾、情報入力を完了します；
4. Web ページに戻り、「スキャン完了、同期開始」をクリックします；
5. ページに実写人物グループと収集で生成された素材が表示されます。まだ処理中の場合は、しばらくしてから更新してください。

実写人物グループはスキャンを開始した現在のアカウントに紐付けられ、他のアカウントはそのセッションを解析または再利用できません。許諾セッションの作成時に一時的に利用できない旨が表示された場合は、そのメッセージを保存してプラットフォームサポートに連絡してください。

検索とフィルタ

• 検索：グループ一覧と素材一覧の両方で、名前または ID による検索をサポートします；
• フィルタ：グループタイプと所属モデルでフィルタでき、特定のモデルで使用するグループと素材のみを表示できます；
• 所属モデル：一覧には最初のモデル名と +N カウントのみが表示されます。その上にマウスを移動すると、このグループまたは素材のすべての所属モデルが一覧表示されます；
• ページネーション：一覧はページ単位で読み込まれ、下部に総件数が表示されます。1 ページあたり 10 / 20 / 50 / 100 件（デフォルト 10 件）を選択できます；
• 更新：現在のアカウントのグループと素材の名前、ステータス、エラー情報、アクセスアドレスを再読み込みします。

素材は 1 回登録するだけで済む

モデルごとにグループを作成したり素材をアップロードしたりする必要はありません。登録時、素材はプラットフォームの統合素材ライブラリに入り、素材参照をサポートするすべてのモデルが同じ素材を直接使用します。素材 ID は変わらないため、モデル間でそのまま再利用でき、モデル側の同期を待つ必要もありません。モデルと素材ライブラリの対応関係は素材ライブラリインターフェースを参照してください。

これ以前の既存素材は、初めてあるモデルから参照された際にプラットフォームが 1 回準備し、準備完了後は直接参照した素材と同じ動作になります。

ライブラリごとの確認（管理者）

管理者は素材ライブラリ管理の上部で、「プラットフォーム素材ライブラリ」と各モデルの素材ライブラリを切り替えられます。あるモデルの素材ライブラリに切り替えると、そのライブラリ内のグループと素材を読み取り専用で確認でき（デフォルトではモデル名のみ表示）、ライブラリ内で直接グループを作成したり素材を送信したりして、特別な準備や調査に使用できます。ライブラリ内の素材送信も同様に画像の直接アップロードをサポートし、名前を空欄にするとファイル名で自動命名されます。

残高、チャージ、請求

残高ページはチャージ、プランの確認、特典の引き換えに使用します。モデルマーケットは概算価格を提供し、タスク完了後の請求が最終的な精算を提供します。異常な課金を照合する際は、タスク ID、リクエスト識別子、モデル ID、時間範囲を使用し、完全なキーは提供しないでください。

LocoPal Creation

• LocoPal Creation：直接制作向けのワークスペースで、スマートモード、AI 描画、AI 動画、AI 音声、ショートドラマ、作品、素材、プロンプトなどの入口を提供します；

Creation は同じ LocoPal アカウントとモデルサービスを共有し、生成結果、タスク、素材は現在のログインユーザーごとに分離されます。

よくあるワークフロー

API 接続

API Key を作成 → モデルを照会 → テスト呼び出しを実行 → ログで照合 → 業務サービスに接続 → タイムアウトとエラー処理を設定。

複数画像と参照動画

公開ネットワークのメディア、またはステータスが「利用可能」の素材を準備 → 非同期動画タスクを作成 → タスク ID を保存 → 終端状態まで照会 → 結果をダウンロードまたは保存し直す。

実写人物動画

実写人物許諾セッションを作成 → 本人がスキャンして収集 → セッションを解析 → 実写人物素材のステータスを照会 → 素材が利用可能になった後、実写人物素材ライブラリをサポートする動画タスクを送信。