よくある質問のまとめ

本ページでは、プラットフォーム利用時によくある質問をテーマ別にまとめています。各項目には原因と実行可能な次のステップを示します。より詳細なインターフェースレベルの調査については エラーコードとトラブルシューティング、制作ワークスペースの問題については Web 制作のよくある問題を参照してください。

アカウントとログイン

Creation を開くと再度ログインを求められるのはなぜですか？

LocoPal Ai が唯一の ID のソースです。Creation は locopalai.com が発行するサブドメイン間のセッション Cookie に依存しており、 この Cookie が失効しているか存在しない場合、サブプラットフォームは統合ログインページに戻ります。

まず確認してください：LocoPal Ai を開くとログイン状態になっているか。ログイン済みなのにサブプラットフォームが未ログインと表示される場合は、 そのサブプラットフォームのページを更新してください。それでも解決しない場合は、LocoPal Ai からログアウトして、もう一度ログインしてください。

別のコンピューターに変えても Creation に個別にログインする必要がありますか？

必要ありません。LocoPal Ai で 1 回ログインすれば、Creation は自動的にログイン状態を取得します。

パスワードの変更やログアウトは他のプラットフォームに影響しますか？

影響します。ログアウト、アカウントの切り替え、パスワードの変更は、Creation を同時に失効させます。これは同じセッションを共有している場合の正常な動作です。

API キー

1 つの Key ですべてのエンドポイントを呼び出せますか？

呼び出せます。モデル、画像、動画、音声、素材のエンドポイントは同じ Key を共有しており、エンドポイントごとに個別に作成する必要はありません。

この Key であるモデルが見えないのはなぜですか？

モデルの表示範囲は、Key が属する呼び出しグループによって決まります。その Key で GET /v1/models をリクエストして確認してください： 返された data にそのモデルが含まれていなければ、そのグループの権限範囲に含まれていないことを示します。

"data": [] が返されるのはどういう意味ですか？

現在の Key が属するグループに利用可能なモデルが 1 つもないことを示します。まずグループの設定が正しいか確認し、それでも不明な場合は Key 名（完全な Key は提供しないでください）を添えてプラットフォームサポートに連絡してください。

Key が漏洩した場合はどうすればよいですか？

すぐにコンソールの「API キー」でその Key を無効化し（自然に期限切れになるのを待つのではなく）、その後、業務用の新しい Key を作成して設定を差し替えてください。 無効化してもアカウントの素材、タスク、履歴には影響しません。

Key をフロントエンドのコードに書いてはいけないのはなぜですか？

ブラウザやモバイルアプリのインストールパッケージに含まれるものは、すべて抽出される可能性があります。Key はサーバー側の環境変数またはシークレット管理サービスに置き、 業務のバックエンドからプラットフォームを呼び出すようにしてください。

モデルと呼び出し

リクエストの model には何を入力すればよいですか？

GET /v1/models が返す data[].id をそのまま入力してください。モデルマーケットのページに表示される表示名は使用しないでください。

「モデルは現在利用できません」または「利用可能なチャネルがありません」と表示される

現在の時間帯にそのモデルへルーティングできないことを示しており、Key に問題があるわけではありません。まずモデル一覧を更新するか、同種のモデルに変更してください。 継続的に利用できない場合は、リクエスト ID を添えてプラットフォームサポートに連絡してください。

テキスト呼び出しで content が空で、finish_reason が length になっている

推論モデルが max_tokens をすべて推論プロセス（completion_tokens_details.reasoning_tokens）に消費している可能性があります。 出力の上限を引き上げるか、推論以外のモデルに変更して再試行してください。

画像エンドポイントで unknown_parameter が返る

一部の画像モデル（GPT Image シリーズなど）は response_format フィールドを受け付けません。このフィールドを削除して再試行してください。 size、quality、response_format のサポート状況は、いずれも現在のモデルを基準にしてください。

返された画像の URL が開けない

画像エンドポイントは短期间有効なアドレスを返す場合があります。できるだけ早く自分のストレージへ保存してください。長期的に再利用する画像は、先に素材ライブラリへ登録し、 その後 asset://<asset_id> で参照してください。

動画タスク

動画が非同期なのはなぜですか？

動画生成には時間がかかるため、プラットフォームは「タスク作成 → 結果照会」の方式で処理します。作成エンドポイントはタスク ID を返すので、 その後に照会エンドポイントで進捗と結果をポーリングしてください。

送信後にローカルでタイムアウトしました。再作成する必要がありますか？

再作成しないでください。 タスク ID を取得した後、ローカルでタイムアウトしても、元のタスクの照会を続けるだけにしてください。再作成すると重複したタスクと重複した費用が発生します。

作成レスポンスに progress がありません。失敗でしょうか？

いいえ。作成レスポンスは id / task_id、status、model、created_at にのみ依存すれば十分です。 object、progress などのフィールドは初回の照会まで現れないことがあり、これらを作成成功の必須条件とみなしてはいけません。

ステータスが failed です。原因はどう確認しますか？

同じレスポンス内の error.code と error.message を読み取ってください。動画の終端状態の失敗は通常 video_generation_failed で、 error.message はすでに整理された読み取り可能な原因です。その中の JSON をさらに解析しないでください。

照会すると重複して課金されますか？

されません。照会は状態を読み取るだけで、費用は発生しません。新しい費用が発生するのはタスクを再作成した場合のみであり、これが重複送信を避けるべき理由でもあります。

素材と実写人物の肖像権許諾

モデルごとに素材を個別にアップロードする必要がありますか？

必要ありません。素材は 1 回登録するだけでプラットフォーム共通の素材ライブラリに入り、素材参照をサポートするすべてのモデルが同じ素材を使用します。 素材 ID は変わらないため、モデルを切り替える際はリクエストの model フィールドを変更するだけで済みます。

素材はいつから使用できますか？

data.asset.status が Active になってから安定的に利用できます。「アップロード中」「処理中」と表示されている間はそのまま保持して待ってください。 同じ失敗項目に対して重複して送信を繰り返さないでください。

素材の送信にはどの画像アドレスを使いますか？

パブリックインターネットから直接ダウンロードできる http(s) アドレス、またはエンドポイントの制限に従って data_url を送信してください。 ブラウザのローカルファイルパスをエンドポイントのパラメータとして使用しないでください。

実写人物素材は通常の画像で代用できますか？

できません。 実写人物素材は、必ず本人がスマートフォンで QR コードをスキャンして生体収集と肖像権の許諾を完了する必要があります。 コンソールのフローは「素材ライブラリ管理 → 新規グループ → 実写人物素材ライブラリ → QR コード生成 → 本人がスキャン → スキャン完了、同期開始」です。

実写人物素材をサポートしないモデルに切り替えるとどうなりますか？

実写人物素材は、それを明示的にサポートするモデルでのみ有効です。サポートしないモデルに切り替えた場合、プラットフォームは自動的に通常の参照画像へ降格させることはありません。 バーチャル素材に変更するか、サポート対象のモデルに戻してください。

素材は他のモデルに影響しますか？

登録はモデルとは無関係です。素材のステータスが利用可能になれば、素材参照をサポートする任意のモデルですぐに使用でき、モデル側での再準備を待つ必要はありません。 既存の素材は、最初に参照された時点でプラットフォームが 1 回準備します。

課金と残高

動画タスクを送信した時点で課金されますか？

されません。非同期タスクは完了時に精算され、送信の成功はタスクを受理するだけで、事前に課金されることはありません。 送信前に、プラットフォームは残高または Key のクォータが今回の推定消費をカバーできるか検証し、不足している場合は読み取り可能なメッセージを直接返してタスクを作成しません。

パラメータ検証の失敗（400）でも課金されますか？

通常は課金されません。400 はリクエストが受理されなかったことを示し、一般的に生成タスクの費用は発生しません。

価格カードに表示される価格がそのまま最終的な課金ですか？

同じではありません。価格カードは見積もり用であり、実際の課金はリクエストの実際の使用量、所属グループ、サーバー側の請求記録を基準とします。 詳細は課金と請求を参照してください。

課金が異常だと感じた場合、どう照合すればよいですか？

タスク ID、リクエストの識別子、モデル ID、期間で具体的な記録を特定し、その後、請求の明細と照合してください。完全なキーは提供しないでください。

プラットフォームと制作ツール

2 つのプラットフォームはどのような関係ですか？

LocoPal Ai が中核であり、アカウント、課金、モデル、素材、タスク記録を提供します。Creation はそれに接続するクライアントです。 詳細はプラットフォーム概要を参照してください。

Creation で生成した素材は API で使用できますか？

使用できます。両者は同じ素材ライブラリを共有しており、素材 ID も同じです。

ページを更新すると再生成されたり、重複して課金されたりしますか？

されません。更新はページの状態を復元するだけであり、タスクを再作成せず、重複して課金されることもありません。実行中のタスクに対して重複して送信しないでください。

それでも解決しない場合

サポートリクエストを送信する際は、以下を提供してください：発生時刻、モデル名、タスク ID またはリクエスト ID、HTTP ステータス（API 呼び出しの場合）、 機密情報を除去したエラーメッセージ、およびリクエストの種類（テキスト / 画像 / 動画 / 音声）。

送信しないでください：API keys、完全な Authorization リクエストヘッダー、ログイン Cookie、実際の人物の資料、 署名付きの完全な素材アドレス。関連する範囲についてはエラーコードとトラブルシューティングを参照してください。