LumaとAIのつなぎ方：Claudeのプラグイン、Luma Agents API、SDK、Connectorsを、公式運営と第三者製に分けて読む

この記事は、公式の資料を2026年10月23日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。公式ページは要約の形で取得したため、読み切れなかった所は「公式の資料では確認できていない」と書き、長い引用はせず言い換えています。

先に結論

• Claudeから使うなら、公式のLumaプラグイン。 公式のGitHubのREADMEは、画像や動画の生成、編集、延長、比率の変更、LumaのミニアプリをClaudeの会話から頼める、と書いています。
• プログラムから使うなら、Luma Agents API。 1つの入口（POST /v1/generations）に、種類を示す type を渡して、画像・動画・動画の編集・比率の変更を頼みます。結果は、あとで取りに行く（ポーリング）形です。
• 素材をLumaに持ち込むなら、Connectors。 Lumaが外のサービスを「読んで足す」ためのもので、Claudeなどの外のAIがLumaを呼ぶ入口ではありません。
• データの流れが違う。 個人向けのアプリは規約で学習に使われうる、APIは学習に使わない、と公式は別々に書いています。どの入口を使ったかで、条件が変わります。
• 名前に注意。 MCPの名前に「Luma」が付いていても、イベント管理サービスのLuma（luma.com）のMCPがあります。別の製品です。

前提：用語をそろえる

• MCP（Model Context Protocol）：AIアプリが外のサービスのツールを呼ぶための共通の約束です。
• OAuth：パスワードを渡さずに、サービスどうしを許可でつなぐしくみです。
• API／SDK：APIはプログラムから呼ぶ入口です。SDKは、その呼び出しを書きやすくするライブラリです。
• ポーリング：結果ができたかを、一定間隔で聞きに行くやり方です。
• Connectors：Luma側から、Google Driveなどの外のサービスへつなぐ機能です。
• Skills：Lumaのボードに保存して使い回す、作業手順のかたまりです。

公式が運営するもの

1. Claude用のLumaプラグイン（lumalabs/luma-plugins）

• ベータかどうか。 READMEには、ベータや実験的という表示は読んだ範囲では見つかりませんでした。対応するモデルの一覧、プランの条件、制限は、公式の資料では確認できていません。
• Claude Motion との連携。 Lumaの公式ニュース（2026年10月8日付）は、Claude Motion でつくったアニメーションを、MCP経由のLumaのコネクタでLumaに開き、見た目を変える、比率を変える、別の版を頼む、といった続きの作業ができる、と書いています。同じ記事は、Claude Motion はClaudeのTeamとEnterpriseのプランでベータ、と書いています。データの扱いは、その記事には書かれていません。
• 実際の操作の確認。 この記事では、これらの手順を動かして確かめていません。

2. Luma Agents API

• 画像の従量課金（料金のページの表示、2K出力）。 uni-1 の文章から画像が$0.0404、uni-1-max が$0.1000。参照画像が1枚で$0.0434／$0.1030（参照が増えるごとに、1枚あたり$0.0030が加わる）。
• 動画の従量課金（ray-3.2、標準の画質）。 5秒で、540pが$0.15、720pが$0.30、1080pが$1.20。10秒で、540pが$0.45、720pが$0.90、1080pが$3.60。HDRは標準の2倍、HDRとEXRは3倍、と lumalabs.ai/api に書かれています。docs.agents の料金のページには倍率の文はなく金額の表があり、HDRは720pの5秒で$0.60、1080pの5秒で$2.40、HDRとEXRは720pの5秒で$0.90、1080pの5秒で$3.60です。そのページには、さらに次の表示があります（米ドル）。360p（下書き）は5秒で$0.06、10秒で$0.18。既存の動画の編集（標準）は、540pで5秒$0.72、10秒$1.44、1080pで5秒$2.16、10秒$4.32。Reframe（比率の変更）は1秒あたり、360pが$0.03、540pが$0.06、720pが$0.12、1080pが$0.36。HDRでの生成は720pと1080pの5秒だけです。docs.agents の料金のページは、動画の料金は一般提供の前に変わることがある、と書いています。
• 契約型。 Provisioned Throughput は1ユニットが uni-1 の1分あたり1リクエスト。月額は1か月の契約で$3,800、3か月で$2,800、1年で$2,100（1ユニットあたり）。docs.agents のFAQの最小は8ユニットです。lumalabs.ai/api のページは、プランの節で「最低4ユニット」、Uni-1.1 のFAQの節で「8ユニット」と書き、同じページの中でも食い違っています。
• BuildとScale。 lumalabs.ai/api は、Build を従量課金で最低契約なし、Scale を専用の処理能力で、SLA、モデレーション、「no-train guarantee（学習しない保証）」つき、と説明しています。Scale は営業に問い合わせです。一方、APIのFAQには、Build と Scale の名前は出てきません。
• キーの取り方。 lumalabs.ai/api は、platform.lumalabs.ai（開発者のダッシュボード）とプレイグラウンドを案内していますが、キーの作り方は書いていません。docs.agents の概要ページ（クイックスタートの3手順を含む）は、キーを環境変数 LUMA_AGENTS_API_KEY に入れると書くだけで、キーの入手先は書いていません。PythonのSDKのREADMEにも、入手先の記載はありません。
• ベータかどうか。 docs.agents.lumalabs.ai に、ベータや実験的という表示は、読んだ範囲では見つかりませんでした。
• ページ上部のナビゲーションに「Admin API」の項目もある。 docs.agents の上部は Guides、API Reference、Admin API の3つで、ガイドの目次には、動画（生成・編集・Reframe）、画像（生成・編集・レイヤー）、ファイル、生成の削除、LLM Inference、料金・上限・エラー・FAQ があります。Admin API の中身は読めていません。

3. 古い「Dream Machine API」とSDK

• docs.lumalabs.ai は、いまも「Dream Machine API」を扱っています（2026年7月10日更新の表示）。ページの上には、最新のAPIは Luma Agents API の資料を見るように、という案内の帯があります。
• 移行ガイド（docs.agents の「Migration guide」）は、Ray 3、Ray 2、Ray 2 Flash などの古い呼び出しを、model: ray-3.2 と type で表す新しい形に置き換える方法を載せています。廃止の日付は書かれておらず、お知らせに書かれる退役日が期限、古い依頼はお知らせの期間中は動く、とあります。
• 公式のPython SDK「lumaai」（pip install lumaai、「Dream Machine SDK for Python」）は、GitHubで公開されています。READMEに廃止の案内は読んだ範囲で見つかりませんでした。
• Ray3.14は、2025年9月時点ではAPIに出ていない、とラーニングセンターのFAQ（2025年9月18日）は書いています。現在のAPIが対応するのは ray-3.2 などです。

4. 公式のMCP（古い世代）：lumalabs/luma-api-mcp

• 公式の組織（lumalabs）のGitHubにあります。READMEは、Claude Desktopなどから、Photon（画像）とRay（動画）を呼ぶMCPサーバーと説明しています。モデル名は photon-1、photon-flash-1、ray-2、ray-flash-2、ray-1-6 で、設定は sh setup.sh でLumaのAPIキーを入れる方法です。ライセンスはMIT。
• READMEの更新状況は読み取れていません。公式の llm-info は、Photon は別の製品としては存在しない、と書いています。現行のLumaプラグインと目的が重なるので、新しく使うなら、プラグインとLuma Agents APIの案内を先に見るのがよさそうです（見立て）。

5. Connectors（外から素材を取り込む）

公式のラーニングセンター「Luma Connectors」（2026年6月14日付）の要約です。

• 対象のサービス。 Google Drive、Dropbox、Frame.io、Box、Airtable の5つです。記事は、ClaudeやChatGPTには触れていません。
• しくみ。 「read-and-add」で、Lumaは読む、取り込む、作る、アップロードする、保存することはできるが、削除、名前変更、上書きはできない、と書かれています。
• つなぎ方。 Connectors のページで、各サービスの標準のOAuth画面でサインインして承認します。Lumaはパスワードを見ず、承認した範囲のアクセストークンを受け取ります。
• 範囲。 接続は、個人ごと、チームごとです。チームの管理者が使える拡張を決めます。
• 止め方。 Pause は、AIからツールを一時的に隠すだけで、接続は残ります。Disconnect は、アクセスを外し、たいていは提供元の側でも取り消されます。
• 書かれていないこと。 プランの条件、MCP、ベータの表示は、記事には書かれていません。

6. Skills（手順の保存と共有）

• ラーニングセンター「Luma Skills & Repeatable Workflows」（2026年6月14日付）は、うまくいった作業の手順をボードに保存して、@で呼び出す、と書いています。共有は、Skills ライブラリのリンクで、別のボードが「Add to board」で取り込みます。Skills ライブラリは、自分の Skills、System Skills、External Skills の3つに分かれる、とあります。
• ClaudeのSkillsやMCPへのリンクは、その記事には書かれていません。

7. 他社の制作ソフトの中のLuma

• Adobeの公式ブログ（2026年9月8日付）は、Premiereの「Generative Media Tool」が、Adobe Fireflyのほかに、Google Veo、Kling、Runway、Luma などの「partner models（提携先のモデル）」を使える、と書いています。プランや提供の時期は、その記事には書かれていません。ベータの表示は、同じツールの Generate Soundscape と Generate Music にあり、Generate Video と Generate Sound Effects には付いていません。この連携の運営はAdobeです。Luma側の記事は読めていません。
• Adobeの公式ブログには、ほかにFireflyにRay3が入った2025年9月18日付の記事もありますが、題名のみ確認し、本文は読んでいません。

第三者が作ったもの

• 他にもあるはずです。 検索では、mcp-luma（PyPI）、Composio のツールキット、別の個人のリポジトリなどの題名も出てきましたが、中身は読んでいません。公式の資料だけを根拠にする方針なので、評価はしていません。
• イベントのLuma。 「luma-mcp」という名前で、イベント管理サービスのLuma向けのMCPもあります。公式のヘルプ（help.luma.com）にも、イベントを探したり、主催するイベントを管理したりするためのLuma（luma.com）の公式MCPが載っています。動画のLumaとは別の製品です。
• 見分け方。 公式のLumaプラグインの接続先は agents.lumalabs.ai です。それ以外のURLは、公式と同じとは限りません。

データはどこへ流れるか

気をつけること

• この記事は、実際に使って確かめた記録ではありません。公式のGitHubのREADME、ドキュメント、ラーニングセンター、ニュース、規約を読んだ範囲です。
• 公式の資料の間で、数字や名前の食い違いがあります（Provisioned Throughput の最小ユニット、Build と Scale の扱い、古い世代のモデル名など）。コードに書く前に、最新の料金と変更履歴を見てください。
• キーやサインインの承認は、人が自分で行うものです。キーをAIの会話に貼らない、コードに直接書かない、環境変数に入れる、と公式のSDKの説明も勧めています。
• ClaudeのTeamやEnterpriseでは、Ownerの操作が先に必要、と公式のREADMEに書かれています。個人のプランでの条件は、公式の資料では確認できていません。
• 公式の記事の数字や評価は、会社自身の説明です。独立した検証は読んだ範囲では見つかっていません。
• 契約や規約の解釈は、必要なら専門家や公式に確認してください。この記事は法律の助言ではありません。

出典

• luma-plugins（Luma AI の公式GitHub、確認日 2026-10-23）
• luma-plugins の luma/README.md（Luma AI の公式GitHub、確認日 2026-10-23）
• Start in Claude Motion. Finish it in Luma.（Luma AI、2026-10-08、確認日 2026-10-23）
• Luma Agents API ドキュメント（Luma AI、確認日 2026-10-23）
• FAQ（Luma Agents API、Luma AI、確認日 2026-10-23）
• Pricing（Luma Agents API、Luma AI、確認日 2026-10-23）
• Rate limits and headers（Luma Agents API、Luma AI、確認日 2026-10-23）
• Migration guide（Luma Agents API、Luma AI、確認日 2026-10-23）
• Luma API（Luma AI、確認日 2026-10-23）
• API Terms of Use（Luma AI、2026-04-28更新の表示、確認日 2026-10-23）
• luma-agents-python（Luma AI の公式GitHub、確認日 2026-10-23）
• lumaai-python（Luma AI の公式GitHub、確認日 2026-10-23）
• luma-api-mcp（Luma AI の公式GitHub、古い世代のモデル、確認日 2026-10-23）
• Dream Machine API ドキュメント（Luma AI、2026-07-10更新の表示、確認日 2026-10-23）
• Luma Connectors（Luma AI ラーニングセンター、2026-06-14、確認日 2026-10-23）
• Luma Skills & Repeatable Workflows（Luma AI ラーニングセンター、2026-06-14、確認日 2026-10-23）
• Ray3.14 Frequently Asked Questions（Luma AI、2025-09-18、確認日 2026-10-23）
• Subprocessors（Luma AI、2026-10-04更新の表示、確認日 2026-10-23）
• Luma — Official Information for AI Assistants（Luma AI、2026-07-13更新の表示。AIアシスタント向けの節を含む。確認日 2026-10-23）
• Generate and create directly in your timeline with new AI-powered innovations in Premiere and After Effects（Adobe、2026-09-08、確認日 2026-10-23）
• AceDataCloud/LumaMCP（第三者、GitHub、確認日 2026-10-23）
• runapi-ai/luma-mcp（第三者、GitHub、確認日 2026-10-23）
• Luma MCP Server（Luma イベント管理サービスのヘルプ、同名の別製品、確認日 2026-10-23）