困ったとき

「モデルが見つかりません」と表示される

1. ウィンドウ右上の状態アイコンをクリックし、「使用中のモデル」と「読み込みエラー」を確認します。
2. 登録したフォルダが、FL2VA フォルダ（参照機能を使うなら Ref2VA も）を直接含む「MiniMax-H3」フォルダかを確認します。FL2VAフォルダそのものや、さらに上のフォルダを登録すると読み込めません。
3. モデルのフォルダを移動した場合は、「モデル管理」の「フォルダを追加…」で新しい場所を登録し直し、そのモデルを選びます。
4. 参照画像・動画・音声を使うときにだけ失敗する場合は、Ref2VAがダウンロードされていない可能性があります。モデルの準備から追加します。

生成がとても遅い

次の順に確認してください。

1. 大きさ：大きいほど時間がかかります。まず「小」や「中」で試します。
2. 長さ：長い動画は、長さ以上に時間が伸びます（512×512の標準設定で、5秒が約6分、15秒が約30分の実測例があります）。
3. 参照ファイル：参照画像・動画・音声を使う生成は時間が長くなりがちです。とくに大きな参照動画は、生成全体を大きく遅くします。
4. 計算方式：M5クラスのMacなら「高速（int8キャッシュ）」になっているか確認します。「省メモリ（SSDストリーミング）」は必要なメモリが少ない代わりに時間がかかります。
5. 空きメモリ：ほかのアプリを閉じてから生成します。メモリが足りずにスワップが起きると、大幅に遅くなります。

「詳細設定」の「サイズ」に、今の設定でのおおよその所要時間が表示されます。1時間を超える見込みのときは注意が表示されます。

ダウンロードが止まった・空き容量が足りない

• ダウンロードは途中から再開できます。止まった場合は、ダウンロード画面の「再開」を押すか、アプリを開き直して同じ保存先でもう一度始めます。ダウンロード済みのファイルは飛ばされます。
• 空き容量が足りないときは、「保存先」の「変更…」で容量に余裕のあるディスクを選びます（ダウンロード中は変更できません）。FL2VAだけで約144.1GB、Ref2VAも含めると約288.1GB必要です。int8キャッシュ（1つ約19.3GB）は、モデルの保存先とは別に内蔵ディスクへ作られます。
• はじめは「Ref2VA も含める」をオフにして、FL2VAだけをダウンロードすると容量を抑えられます。

「高速モード（試験的）」が表示されない

「高速モード（試験的）」は、M5クラスのGPU（ハードウェアのTensor演算ユニットを持つGPU）で、対応するビルドのときだけ詳細設定に表示されます。GitHubで配布しているDMGは対応ビルドです。M4以前のチップでは表示されません。

計算方式の「高速（int8キャッシュ）」や、速度の「高速」とは別の機能です。違いは速度に関わる3つの設定をご覧ください。

動画はどこに保存される？

複数本の生成にプロジェクトが必要な理由

プロジェクトを開いていないときの動画は一時ファイルで、次の生成で消えてしまいます。複数本を続けてつくると前の動画が残らないため、保存先となるプロジェクトが必要です。プロジェクトなしで2本以上を選んで生成すると、新しいプロジェクトをつくるか既存のプロジェクトを選ぶ画面が出ます。くわしくはプロジェクトと複数生成をご覧ください。

古いmacOS・Intel Macで動かない

H3cAppはApple SiliconのMac・macOS 15 Sequoia以降が対象です。macOS 14以前では起動できず、Intel Macには対応していません。

v0.4.3までの説明には「macOS 13以降」とありましたが、生成に使う仕組みが実際にはmacOS 15を必要としていたため、v0.4.4で動作条件を改めました。

起動時に警告が出る

GitHubのリリースページで配布しているDMGは、署名とAppleの公証を済ませています。それでも警告が出る場合は、次を確認してください。

• 公式のリリースページからダウンロードしたものか。
• アプリの版（メニューの「H3cAppについて」）と、Macの対応OS（macOS 15以降）。

Gatekeeperを無効にするなどの操作はおすすめしません。判断に迷うときは、Appleの案内「Macでアプリを安全に開く」を参照してください。

以前の版から更新する

新しいDMGを開き、H3cAppをアプリケーションフォルダへドラッグして置き換えます。設定、プリセット、登録したモデルは引き継がれます。v0.3.0以前は「h3c-app」という名前のアプリだったため、v0.4.0以降を入れたら古い h3c-app.app は削除してかまいません。v0.6.0では、モデルやキャッシュを置くフォルダの名前も ~/Library/Application Support/h3c-app から H3cApp に変わります。最初に起動したときに自動で名前を変え、登録したモデルやLoRAの場所も合わせて書き換えるので、手で移す必要はありません。

不具合を報告したい

GitHubのIssuesで受け付けています。次の情報があると調べやすくなります。

• アプリの版（例：0.4.7）、macOSの版、チップ（例：M5）、メモリ容量
• 作り方、画面の形・大きさ・長さ、詳細設定（計算方式・速度・高速モードなど）
• 何をしたら、どうなったか（再現する手順）と、表示されたエラーの文言

Issuesは公開されます。人に見せたくないプロンプトや、名前を含むファイルの場所などは書かないでください。

ライセンスと利用条件

• アプリ本体（H3cApp）：MIT License。Salvatore Sanfilippo氏（antirez）のh3.cをもとにしています。同梱しているほかのソフトウェアの表記はTHIRD_PARTY_NOTICES.mdにあります。
• 動画生成モデル（MiniMax H3）：H3cAppは動画の生成にMiniMaxのMiniMax H3を使っています。モデルにはアプリとは別の、MiniMax H3独自の少し特殊なライセンス（MiniMax H3 Community License）が適用されます。一般的なオープンソースのライセンスとは条件が異なるので注意してください。主な点は次のとおりです（要約です）。
  • ライセンスの対象となる地域が定められていて、EU、英国、韓国、米国は対象外とされています。
  • 利用方針（Acceptable Use Policy）で禁止されている使い方があります。
  • モデルや生成した動画を、ほかのAIモデルの改善に使うことは認められていません。
  • 商用の製品・サービスで使う場合の条件（一定以上の売上での事前の許可、画面への「MiniMax H3」の表示など）があります。
  利用の前に、必ずライセンス本文と、提供元のライセンスに関するQ&Aを確認してください。
• 追加モデル（LoRA）：それぞれの配布元の条件に従います。

商用利用などの可否は、このサイトでは判断できません。上記の最新のライセンスを確認してください。アプリは無料で配布していますが、モデルのダウンロードの通信量や、生成にかかる電力などは利用者の負担になります。