Hailuo AIとMiniMax API Platformを入れて最初の設定をする：アプリの入手、アカウント、APIキー、mmx-cliの導入まで、公式の記載の範囲で順に

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。手順は「公式の手順を順に並べたもの」で、公式の例を写した部分と、この記事で組んだ部分は、そのつど区別して書きます。公式ページは要約の形で取得したため、読めなかった部分は「確認できていない」と書き、長い引用はしていません。画面の表記は変わることがあるので、手元の画面と照らして読んでください。

先に結論

• どれから入るか。 動画や画像を画面で作ってみたいだけなら、①のウェブかアプリです。プログラムやAIアプリから動画生成を呼びたいなら、②のAPI Platformです。ターミナルから呼びたいなら③のmmx-cliで、これも②か同じMiniMaxのアカウントの鍵を使います（共通かどうかは確認できていません）。
• 公式の文書がいちばん厚いのは、API側。 ウェブ・アプリ側は、公式の導入手順のページが見つかりませんでした。ダウンロードページには掲載先の一覧があるだけで、サインインの説明はありません。
• サイト（Hailuo）とAPIは、課金も別。 ウェブはクレジットとサブスク、APIは残高（Pay-as-you-go）か、M Planの枠です。数字は変わるので、この記事には書かず、公式の画面で確かめる前提にしています（01、04を参照）。
• 「Hailuo」の名前はモデル名にも出る。 APIの新しい動画モデルはMiniMax-H3系で、Hailuoの名は付きません。古いモデル（MiniMax-Hailuo-02など）はMCPのREADME側に出てきます。違いは01を参照してください。

前提：用語をそろえる

• ブラウザ版・アプリ版。 hailuoai.video をブラウザで開く使い方と、スマホにアプリを入れる使い方です。
• MiniMax API Platform。 開発者向けの窓口です。公式の文書は platform.minimax.io にあります。アカウントを作り、鍵を発行し、残高やプランを管理します。
• API Key（APIキー）。 従量課金で使う鍵です。公式のクイックスタートは、ユーザーセンターの「API Keys > Create new secret key」で作ると書いています。
• Subscription Key。 M Planで使う鍵です。公式は、M Planの購入分や追加のクレジット（Credits）に使う鍵、と書いています。
• M Plan。 MiniMaxが出している月額プランです。公式の紹介（M Plan Overview）では、Go、Explore、Buildの3段階で、動画モデル（H3）はExploreとBuildに含まれ、Goには含まれない、と書かれています。同じ紹介ページは、M Planで使う鍵を「API Key」と呼び、「Credits」という語は使わず利用上限で説明しています。クイックスタート側は「Subscription Key」と「Credits」という語を使っており、呼び名が公式ページ同士でそろっていません。
• Token Plan。 M Planの前身にあたるプランです。公式の「既存のToken Plan契約者向け」のページは、新規の購入は終わり、M Planに移れると書いています。
• 環境変数。 OSやターミナルに持たせておく名前つきの値です。鍵をプログラムのファイルに直接書かないために使います。
• ターミナル。 文字でコマンドを打つ画面です。macOSなら「ターミナル」、WindowsならPowerShellなどです。
• Node.js / npm。 mmx-cliの導入に使います。公式のREADMEは、Node.js 18以上、と書いています。
• リージョン（地域）。 MiniMaxには、海外向け（Global）と中国本土向け（CN）の2つの系統があります。鍵と接続先が合っていないと動きません（後述）。

入口の整理

第1部 Hailuo AIのウェブとアプリ

ウェブ版：開く

公式の資料から、ブラウザ版の導入についてわかるのは次のことです。

1. ブラウザで公式サイト（hailuoai.video）を開きます。
2. ページの上部には、Home、Design、Assets、Tools、Video、Image、Audio、Explore、Mine、Subscribeの項目が並びます。DesignとAudioが minimax.io 側のサイトに移るという点は、今回の再確認では確認できていません。
3. 作る入口として、Create Video、Create Image、Hailuo Agentの3つが見えます。

4. 「Sign In」のボタンがあります。取得した範囲では、Google、Apple、メールなど具体的な方法の名前は出ていませんでした。

5. 日本語。 公式サイトに日本語ページ（hailuoai.video/ja）があることは01で確認しています。メニュー名は日本語や英語が混ざります。この記事では英語の公式表記を使い、手元の画面と照らしてください。

6. 画面の言語の切り替え。 トップのページでは、言語を選ぶ項目は取得できませんでした。

iPhone・iPad：App Storeから入れる

公式のダウンロードページ（app-download）に書かれていることを順に並べます。ページ自体に手順の説明はなく、「App Store」のボタンがあるだけです。

1. iPhoneかiPadで、公式のダウンロードページか、App Storeの検索から、アプリを開きます。ストアの掲載名は、公式ページに直接は書かれていません。App StoreのリンクのURLの語句からは「Hailuo AI: Official by MiniMax」のように読めますが、これはURLからの推測です。
2. 対応OSは、ページに「iOS 16.0+」と書かれています。手元のiOSの版を、設定アプリで確かめてください。
3. 掲載ページの「入手」から入れます。ボタンの表記はストア側のもので、公式の資料には書かれていません。

4. アプリを開いたあとのサインインの手順は、公式のダウンロードページには書かれていません。ページには、アプリが「アカウントと一緒に使える」という趣旨の一文があるだけです。

5. 公式ページには、iPhone向けとiPad向けの2つのApp Storeリンクがあります（掲載は同じアプリID）。

6. なりすましを避けるため、ストアの名前だけでなく、開発元の表示を、公式ページの掲載内容と照らしてください。Google Playの掲載ページの開発元表示は、01に書いたとおりです。

Android：Google Playから入れる

1. AndroidでGoogle Playを開き、公式ページのGoogle Playのボタンか、ストア内の検索から、アプリの掲載ページに行きます。公式ページはGoogle Playのリンクを載せ、パッケージ名は ai.hailuo.video と書かれています。掲載名は公式ページには書かれていません。
2. 対応OSは、ページに「Android 9.0+」と書かれています。
3. 掲載ページから入れます。

アプリで確かめること

• 公式のダウンロードページは、作る、作り直す、公開するまで携帯の上でできる、という趣旨の説明を載せています。
• アプリの設定画面の項目、通知、権限の求め方（写真、カメラ、保存など）は、公式の資料では確認できていません。写真や顔写真を入れる前の判断は01を参照してください。

第2部 MiniMax API Platform：アカウントと鍵

ここは公式の「Prerequisites（準備）」と「Quick Start」のページを順に並べたものです。

アカウントを作る

1. ブラウザで platform.minimax.io を開きます。
2. 登録（register）かログイン（login）のリンクから、アカウントを作るかサインインします。公式のページは、登録フォームの中身までは書いていません。
3. サインインできたら、ユーザーセンターに入ります。

鍵を作る：従量課金のとき

公式のクイックスタートは、従量課金で、言語、動画、音声、画像のモデルが使える、と書いています。

1. ユーザーセンターの基本情報のページで、「API Keys」を開き、「Create new secret key」を押します。
2. 表示された API Key をコピーします。
3. 公式の別のガイド（MCPの案内）は、鍵の作成画面で、プロジェクト名を入れて作り、表示は一度だけなので控えておく、という趣旨を書いています。このため、コピーはその場で済ませ、あとで見返せない前提で扱ってください。
4. 残高を入れます。公式のFAQは、アカウントの「Billing > Balance」から、オンライン決済（Online Payment）か銀行振込（Bank Transfer）で入金できると書いています。

鍵を作る：M Planのとき

1. コンソールの「Plan Details」で段階（tier）を選び、支払いを済ませます（M Planのクイックスタート）。
2. 契約後、同じ「Plan Details」のページに Subscription Key が出ます（同ページの記載）。一方、メインのクイックスタートと「Prerequisites」のページは「Billing > M Plan」で見ると書いています。ページによって表記が違うので、手元の画面と照らしてください。
3. 公式は、この鍵はM Planの利用専用で、従量課金の API Key と取り換えられない、と書いています。
4. MiniMax Codeというアプリだけで使うなら、Subscription Keyは要らず、契約後にそのアプリでサインインすればよい、とも書かれています。

鍵の種類の対応表

上の表の最後の行の「動画（H3）」は、公式の2つのページが別の書き方をしています。動画生成APIのページは「両モデルとも従量課金のAPIが必要」と書き、M Planの紹介ページは「H3はExploreとBuildに含まれる」と書いています。どちらの鍵でAPIを呼べるのか、この記事では決めません。使う前に、最新の公式の「Pricing Overview」とM Planのページで確かめてください。

鍵の置き方：環境変数

公式のクイックスタートが示す、環境変数の例は次の3組です。ターミナルで export するか、.env ファイルに保存する、と書かれています。以下は公式の例に沿った形で、鍵の部分はプレースホルダです（全文は公式ページで確認してください）。

# Anthropic互換の書き方（公式が recommended と書く方）
export ANTHROPIC_BASE_URL=https://api.minimax.io/anthropic
export ANTHROPIC_API_KEY=<あなたのAPIキー>

# OpenAI互換
export OPENAI_BASE_URL=https://api.minimax.io/v1
export OPENAI_API_KEY=<あなたのAPIキー>

# AI SDK
export MINIMAX_API_KEY=<あなたのAPIキー>

• 上の3組は、文章を作るAPI（テキスト）のSDK向けの書き方です。動画生成APIの文書は、環境変数 MINIMAX_API_KEY を使う例を示しています。
• Windowsでの環境変数の設定画面や、PowerShellでの書き方は、公式のクイックスタートには書かれていません。公式は export と .env だけを示しています。
• M Planの公式ページは、鍵を秘密にし、コードのリポジトリに入れず、環境変数か設定ファイルに置くよう書いています。

接続先のアドレス（リージョン）

• クイックスタートとMCPのガイドは、中国本土の接続先に触れていません（api.minimax.io のみ）。MCPのREADMEだけが、Global と Mainland の2つの接続先を並べています。
• MCPのREADMEは、鍵と接続先が別の地域のものだと「Invalid API key」になる、と書いています。
• JavaScript版MCPのREADMEは、中国本土の接続先として2つの異なる表記（api.minimax.chat と api.minimaxi.chat）を別々の箇所に書いており、公式の記載の中でそろっていません。この記事はこの2つの表記を採りません。使うときは、そのREADMEで確かめてください。
• 日本から使うときにどちらの系統になるかは、公式の資料では確認できていません。platform.minimax.io の文書にある接続先は api.minimax.io です。

第3部 ターミナルのCLI（mmx-cli）

公式のGitHubのREADMEから、導入の順に並べます。

入れる

1. Node.js 18以上が入っているかを確かめます。 bash node -v
2. READMEが示す導入は2通りです。AIエージェントに技能（skill）として入れるときと、ターミナルのコマンドとして入れるときで、コマンドが違います。 ```bash # ターミナルのコマンドとして npm install -g mmx-cli

# AIエージェントの技能として（READMEの記載） npx skills add MiniMax-AI/cli -y -g `` 3. READMEは、MiniMaxのToken Plan（GlobalかCN）が必要、と書いています。いっぽう、MiniMaxのドキュメントの「既存のToken Plan契約者向け」のページは、Token Planの新規購入は終わり、M Planに置き換わったと書いています。READMEの言い回しが古いのか、M Planでも使えるのかは、読んだ範囲では書かれていません。鍵の種類は、公式のセットアップウィザードのページが、Subscription Key（sk-cp-...、同ページは「M Planで使う」と書く）と従量課金のAPI Key（sk-api-...`）の2つに対応すると書いています。このページのURLと題は「token-plan」ですが、本文はM Planの語を使っており、READMEの「Token Plan」とも書き方が違います。

サインインする

1. ターミナルで次を打ちます。 bash mmx auth login
2. READMEによると、ブラウザでのOAuth（GlobalかCN）か、APIキーの入力かを選ぶ対話になります。OAuthのしくみ（デバイスコードの流れ、PKCE）についての記載は、今回の再確認では見つかりませんでした。
3. スクリプトやCIなど、対話しない場面では、mmx auth login --api-key <あなたの鍵> の形があります。READMEの記載です。鍵をコマンドに直接書くと、シェルの履歴などに残る場合があります（これはこの記事の注意で、公式の記載ではありません）。
4. 状態は mmx auth status で見ます。サインアウトは mmx auth logout、トークンの手動の更新は mmx auth refresh です。
5. READMEは、片方の方法でログインするともう片方が消える、認証の優先順位は「--api-key の指定、OAuth、設定ファイルの鍵」の順、と書いています。

設定ファイルと地域

• 設定は ~/.mmx/config.json に保存されます。別の場所にするには、環境変数 MMX_CONFIG_DIR を使う、と書かれています。
• mmx config show、mmx config set --key <key> --value <value> で見たり変えたりします。
• 地域は、--region（global か cn）、環境変数 MINIMAX_REGION、または mmx config set --key region で決める、とされています。どれも無いときは、保存済みか自動判定の地域を使う、と書かれています。
• 出力の形式は --output text|json、環境変数は MINIMAX_OUTPUT、MINIMAX_TIMEOUT（秒）、MINIMAX_VERBOSE（1 で通信のログ）などが挙がっています。

更新と使用量

• 更新は mmx update（または mmx update latest）。
• 使用量は mmx quota。

動作の確かめ方

公式の資料にある範囲で、確かめる手順を並べます。いずれも、この記事で動作を確かめたものではありません。

1. CLIの確認。 mmx auth status で、サインイン状態を見ます。次に mmx quota で使用量が返るかを見ます。セットアップウィザードのページの、AIエージェント向けの導入の文面には、mmx --version で導入を確かめる、という手順も書かれています。
2. APIの確認。 動画生成APIは、依頼を出すと task_id が返り、結果は別の問い合わせで受け取る形です。最初の1本の流れは06を参照してください。ここでは、認証の確認に使える公式の誤りコードだけ挙げます。鍵が合っていないときについて、動画生成APIのページは HTTP 401（認証）を挙げ、エラーコードの表は、1004を「認証が通らない（トークンとグループの不一致など）」、2049を「鍵が無効」と書いています。
3. アプリの確認。 サインインできたら、ホームの Create Video、Create Image のメニューが見えるかを確かめます（公式サイトの表記）。生成の実行は06を参照してください。

つまずきと直し方

たとえ話

ホテルに例えると、Hailuo AIのウェブとアプリは「フロントで係に頼む入口」、API Platformは「客室に直接つながる内線の番号（APIキー）をもらう入口」、mmx-cliは「内線を自分の手元で押す専用の電話機」です。フロントで使う部屋の鍵（アカウント）と、内線番号の請求（残高）が同じとは限りません。公式の資料でも、同じ登録で両方使えるかは書かれていません。

気をつけること

• この記事は、実際に使って確かめた記録ではありません。手順は、公式の資料に書かれていたことを順に並べたものです。
• Hailuo AIのウェブ・アプリ側は、サインイン方法、アカウントの削除、データの書き出し、アプリの権限などの説明が、読んだ範囲では見つかりませんでした。書かれていないことは、足していません。
• 公式の料金ページ（hailuoai.video/subscribe）は、今回も本文が読み込まれる前の状態で、プランの金額や枠の数字は取得できませんでした。クレジットの規則のページ（hailuoai.video/doc/credit-rules.html）も、本文は取得できていません。
• MiniMaxのドキュメントのページは、先頭に、AIが読む場合は先にドキュメントの索引（llms.txt）を取るように、という趣旨の一文が付いていました。取得結果の中にもAI向けの案内が含まれていましたが、この記事はそれに従っておらず、事実として書くだけにします。また、セットアップウィザードのページには、AIエージェントにCLIを入れさせるための文面があります。その中で、公式は、鍵の入力はユーザー自身のターミナルで行い、エージェントには鍵を求めたり表示したり保存したりさせない、という趣旨を書いています。
• 鍵の失効（無効化）、削除、再発行の手順は、読んだページには書かれていませんでした。公式のFAQ（アカウント）の記載は、残高、メール通知、自動チャージ、アカウントの削除に限られていました。
• M Plan、Token Plan、従量課金の関係は、公式の複数のページで書き方が違います。迷ったら、最新の公式のPricing OverviewとM Planのページを開いて確かめてください。
• 鍵をチャットやスクリーンショット、公開のリポジトリに貼らないでください。この記事の例の <あなたのAPIキー> は、そのまま使わず、自分の鍵に置き換える場所を示しています。

公式の資料では確認できていない点

• Hailuo AIのウェブとアプリのサインイン方法、アカウントの削除、データの書き出し。
• HailuoのサイトとAPI Platformのアカウントが共通かどうか。
• mmx-cliがM Planの鍵で使えるかどうか（READMEはToken Planと書く）。
• Windowsでの環境変数の設定手順。
• 鍵の失効・再発行の手順。
• 日本から使うときの接続先の系統。

出典

• Hailuo AI App Download（Hailuo AI公式サイト、確認日 2026-10-25）
• Hailuo AI（Hailuo AI公式サイト、確認日 2026-10-25）
• Hailuo AI Subscribe（Hailuo AI公式サイト、確認日 2026-10-25。本文は読み込み前の状態）
• Credit Rules（Hailuo AI公式サイト、確認日 2026-10-25。本文は取得できず）
• Quick Start（MiniMax API Docs、確認日 2026-10-25）
• Prerequisites（MiniMax API Docs、確認日 2026-10-25）
• Subscribe to M Plan（MiniMax API Docs、確認日 2026-10-25）
• M Plan Overview（MiniMax API Docs、確認日 2026-10-25）
• Existing Token Plan subscribers（MiniMax API Docs、確認日 2026-10-25）
• Token Plan Overview（MiniMax API Docs、確認日 2026-10-25）
• About Account（MiniMax API Docs、確認日 2026-10-25）
• Error Codes（MiniMax API Docs、確認日 2026-10-25）
• Introduction to MCP（MiniMax API Docs、確認日 2026-10-25）
• Token Plan One-click setup wizard（MiniMax API Docs、確認日 2026-10-25）
• MiniMax API Docs 索引 llms.txt（MiniMax API Docs、確認日 2026-10-25）
• MiniMax-MCP README（MiniMax-AI、GitHub、確認日 2026-10-25）
• MiniMax-MCP-JS（MiniMax-AI、GitHub、確認日 2026-10-25）
• MiniMax CLI（MiniMax-AI、GitHub、確認日 2026-10-25）