OpenArt CLI でターミナルから画像と動画を生成

OpenArt CLIとは

OpenArt CLI は、ターミナルからアクセスできる単一のバイナリで、次を利用できます OpenArt アカウントに、macOS、Linux、Windows で対応。ブラウザから一度サインインするだけです openart login。OAuthフローにより、PythonやNodeをインストールしたり、APIキーを作成したり、長期間有効なキーをスクリプトに保存したりする必要がなくなります。

ログインコマンドは、パスワードを直接扱わずに済むようデスクトップアプリが用いるブラウザリダイレクト方式と同じ、PKCE 付きの標準的な OAuth フローを使用します。CLI は取得した認証情報を次の場所に保存します ~/.openart/cli-credentials.json （モード 0600となっているため、あなたのユーザーアカウントだけが読み取れます。Windows では次の場所に保存されます %USERPROFILE%\.openart\cli-credentials.json）を自動的に更新します。 openart logout 認証情報を取り消し、そのローカル状態をクリアします。

OpenArtはCLIを、Webアプリを裏でクリックして操作するスクリプトではなく、独自の製品面として構築しました。そのコマンドは次を公開します 画像 と 動画生成、モデル情報、作成ステータス、アップロード、プロジェクト、ワークスペースをシェルスクリプトやコーディングエージェントに直接提供します。機械可読な出力、リクエストのプレビュー、非同期ジョブ、制限付きポーリングにより、再現可能な自動化をサポートします。

CLIはOpenArtアカウント自身のクレジット、つまりWebアプリが使うのと同じプールから消費します。独自のキーと課金を持つ別のAPI製品ではありません。 OpenArt CLI の GitHub リポジトリ には、公式のインストール手順、コマンドリファレンス、最新のリリース情報があります。

OpenArt CLI のインストール方法

OpenArt CLIは、単一のビルド済みバイナリとしてmacOS、Linux、Windowsをサポートしています。macOSまたはLinuxでは、公式インストーラーを実行してください。

curl -fsSL https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.sh | sh

Windows では PowerShell を開き、1行のインストーラーを実行します。

irm https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.ps1 | iex

インストーラーはお使いのマシンに適したビルドを選択し、リリースのチェックサムで検証したうえで、次の場所に配置します openart 標準の実行可能ディレクトリに配置します。macOSとLinuxでは次を使用します /usr/local/bin その場所が書き込み可能な場合、または ~/.local/bin ユーザーレベルのインストールを行い、次のような入力を求めることはありません sudo 予期せず。インストーラーが以下を使う場合 ~/.local/binでは、そのディレクトリがシェルの以下にあることを確認してください PATH。Windowsでは次の場所にインストールされます %LOCALAPPDATA%\Programs\openart\bin そのフォルダをユーザーに追加します PATH 自動的に行われるため、管理者権限は不要です。

どちらのインストーラースクリプトも、カスタムインストール先や固定バージョンを指定できます。macOSまたはLinuxでは、スクリプトの後にフラグを追加します。

curl -fsSL https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.sh | sh -s -- --prefix "$HOME/.local" --version 0.1.0

パイプで渡すPowerShellスクリプトは直接パラメータを受け取れないため、まずバージョンを環境変数として設定してください。

$env:OPENART_VERSION = '0.1.0'
irm https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.ps1 | iex

スクリプトをシェルにパイプするのは避けたいですか？お使いのプラットフォーム向けのアーカイブは次からダウンロードできます 最新リリース （macOSのApple siliconまたはIntel、Linuxのx86-64またはarm64、Windowsのx86-64またはarm64）、展開して、次を配置します openart お使いの PATH。各リリースには次が同梱されます checksums.txt 以下で確認できます shasum -a 256 -c checksums.txt --ignore-missing.

後でアップグレードするには、同じインストーラーを再実行してください。既存のバイナリをその場で上書きします。

新しいターミナルウィンドウでインストールを確認します。

openart --help

次に、CLIをOpenArtアカウントに接続します。

openart login

ログインコマンドは OAuth 認証用のブラウザを開きます。アクセスを承認すると、API キーや Python・Node などの言語ランタイムがなくても、CLI があなたのアカウントを利用できます。

主要コマンド一覧

コアとなるコマンド群

認証とアカウントアクセス

OpenArtはアカウントアクセスにブラウザOAuthを使用します。次でセッションを開始します openart login、次で終了します openart logout、プランやクレジット残高は次で確認できます openart account.

openart login
openart account
openart logout

画像・動画生成

OpenArt では、すべての生成コマンドでメディアタイプを明示的に指定します。別々の image と video コマンドにより、スクリプトが誤って間違ったモデルタイプへリクエストを送ることがなくなります。

対象： テキストから画像を生成 または 画像から画像への編集プロンプトとモデル ID を指定して image コマンドを使用します。次を追加します --image 参照としてローカルファイルまたはURLを指定するときに使用します。

openart generate image "A ceramic mug on a studio table" \
  --model nano-banana-2 \
  -o ./out/

上記の例で使用しているのは nano-banana-2；任意のモデルに差し替えてください openart model list が表示します。

対象： text-to-video または 画像から動画は、videoコマンドを使用します。サポートされるオプションには、モデルに応じて長さ、アスペクト比、解像度などがあります。

openart generate video "Slow camera orbit around the product" \
  --model kling-3-omni \
  --image ./start-frame.png \
  --duration 8

モデルの選択とリクエストパラメータ

モデルコマンドを使えば、前提をハードコーディングする代わりに現在のオプションを確認できます。 openart model list 利用可能なモデルとそのサポートされているモードを表示します。OpenArtが新しいオプションを追加すると、モデル名が変わることがあります。

openart model list
openart model cost
openart model cost --model nano-banana-2 --mode text2image
openart model form nano-banana-2 text2image

openart model cost 単独で実行すると、クレジットを消費せずにすべてのモデルを安い順に一覧表示します。次を追加します --model と --mode 特定の組み合わせの価格を見積もります。 form コマンドは、特定のモデルとモードが受け付ける正確なパラメータを返します。2つのうちどちらかを選ぶ際には、次を確認してください GPT Image 2とNano Banana 2の比較 バッチジョブを1つに確定する前に。

作品と保存済みアセット

生成コマンドを使うと、スクリプトから生成履歴を確認したり、投入したジョブを管理したりできます。次を使用します list 過去の作品を確認するには、 get 1つのジョブに、そして wait スクリプトが非同期ジョブの完了まで一時停止する必要がある場合に使用します。

openart creation list --type video --limit 10
openart creation get <creation-id>
openart creation wait <creation-id>

プロジェクトとワークスペースのコマンドで、新しい作業の保存先を制御します。

openart project list
openart project create --name "<name>"
openart workspace list
openart workspace select <workspace-id>
openart workspace select

workspace select 引数なしで実行すると個人ワークスペースに戻り、そして workspace list アクティブなものをアスタリスクで示します。

再利用可能な参照ファイルには、 openart upload add <file> は、アセットを一度アップロードして後続のコマンド用にURLを出力し、 openart upload list --type image は、すでにアップロードしたものを表示します。 公式CLIリポジトリ には、機能の進化に合わせた最新のコマンドリファレンスが掲載されています。

CLIには組み込みのアンインストールコマンドがないため、アンインストールは手動で行います。macOSまたはLinuxでは、次でバイナリと保存された認証情報を削除してください rm "$(command -v openart)" と rm -rf ~/.openart。Windowsでは、削除します %LOCALAPPDATA%\Programs\openart、ユーザーから削除します PATH、そして削除します %USERPROFILE%\.openart。報告する価値のあるバグに遭遇したら、次の出力を含めてください openart version を issue に記載してください。正確なビルド、プラットフォーム、コミットが報告されます。

クリックではなくスクリプト向けに設計されたフラグ

OpenArt CLIは、スクリプト内での生成を予測可能にするコントロールを備えています。それぞれが、構造化された解析、意図しない消費、長時間実行ジョブ、停止したプロセスといったよくある自動化の課題に対応します。

the --json フラグは機械可読な結果を標準出力に書き込みます。進捗やページネーションのメッセージは標準エラーに出力されるため、CIジョブやエージェントのツール呼び出しは、人間可読なテキストをスクレイピングすることなく、クリーンなJSONを別のコマンドにパイプできます。スクリプトは作成ID、ステータス、結果URLを確実に抽出できます。

the --dry-run フラグは、書き込みやクレジット消費を伴うコマンドについて、実際に送信せずにOpenArtが送るリクエストの内容を正確に表示します。バッチループを始める前にモデルの選択やパラメータを確認したり、エージェントが書き込みや消費アクションの実行許可を得る前に生成されたコマンドをプレビューしたりするのに使えます。

the --async フラグは生成をサブミットし、待機せずにすぐに作成IDを返します。バッチスクリプトは複数のジョブをサブミットし、他の作業を行い、後で次を使用できます openart creation wait または openart creation get 結果を収集します。なぜなら --async はダウンロードできるファイルが存在する前に返るため、次と組み合わせることはできません -o または --output.

なしの場合 --async、OpenArt CLIはジョブを送信し、完了までポーリングします。ポーリングは設定した値で停止します --timeout。デフォルトは5分です。待機時間に上限を設けることで、生成の失敗やネットワークの不具合によってCIジョブが無限に実行され続けるのを防げます。一方、明示的にタイムアウトを指定すれば、時間のかかる動画ジョブにも対応できます。

なぜブラウザだけでなくCLIなのか

コマンドラインインターフェースはマウスよりも古くから存在します。最初のコマンドラインインタープリタは1961年にMITのCTSSシステムで動作し、そこから始まったシェルスクリプトの伝統は、1971年の最初のUnixシェル、1977年のBourneシェルを経て受け継がれ、今日でもほとんどのサーバー、CIパイプライン、開発者ツールの自動化に使われています（Wikipedia). GitHub自身の解説 は実用的な利点を端的に示しています。CLIは何度もクリックする代わりに数回のキー入力でタスクを完了し、グラフィカルインターフェースに比べてわずかなリソースしか使わず、繰り返しの作業を一連の手動操作ではなくスクリプトに変えます。

コマンドを実行するのが人ではなくAIエージェントになると、その利点はさらに大きくなります。LLMはテキストネイティブなので、テキストで入出力するCLI形式なら、クリックが成功したかどうかを知るためにスクリーンショットを解析する必要はありません。 Parallelのエンジニアリングチーム は、CLI アクションが決定論的であり、同等のブラウザ自動化よりもはるかに低コストであると主張しています。レンダリングするページも、解釈すべきレイアウトも、コマンド実行後に何が起きたかの曖昧さもないからです。 Claude自体は画像や動画を生成できません。だからこそエージェントには、生成できるモデルに到達する手段が必要なのです。これはClaude CodeやCodexがターミナルを作業場所とする理由でもあり、そして openart generate image ... は、ブラウザセッションを操作するよりもそれらのエージェントに自然にフィットします。

この用語自体、毎日使う人々の間でも今なお議論されています。r/AskProgrammingでは、開発者たちがCLIとフルスクリーンのターミナルプログラムであるTUIとの違いを掘り下げました。CLIは行ベースで、コマンドを入力して応答を得てから次の行に進みます。一方、vimやhtopのようなものは画面全体を描き直し、その中を自由に移動できます（r/AskProgramming). openart は、その狭い意味でのCLIです。すべてのコマンドは入力1行、結果1つで、まさにスクリプトやエージェントが期待する形であり、インタラクティブなダッシュボードになろうとしない理由の一つでもあります。

CLI と MCP：適切な操作方法の選び方

OpenArt CLIは、すでにターミナルで動作しているワークフロー、つまりスクリプト、バッチ生成、CIジョブ、コマンドと機械可読な出力が次のステップに渡るシェルベースの自動化に適しています。

Claude CodeやCodexなどのコーディングエージェントは、既存のシェルアクセスを通じてCLIを呼び出せます。別の統合レイヤーを追加する必要がなく、エージェントは手動で実行するのと同じコマンドを使用します。

OpenArt's MCPサーバー Claude内での対話的なクリエイティブ作業に適しています（参照： Claudeから動画を生成する例), ChatGPT、またはCursorを代わりに。MCPを使うと、エージェントがチャットの途中でOpenArtのツールを呼び出せます。これは、画像や動画を説明し、スクリプトではなく会話を通じて洗練させていく反復的なリクエストに適しています。より広く選択肢を比較したい場合は、こちらと比較したものをご覧ください 画像・動画生成のための他のMCPサーバー.

どちらもOpenArtのWebアプリを置き換えるものではありません。ビジュアルなコントロールや直接の確認が必要なときは、Webアプリが今も最適な選択肢です。CLIは繰り返し実行するターミナル作業に、MCPはチャットベースのやり取りに向いています。作業の大半が行われている場所を選びましょう。構築中のエージェント向けにCLIとMCPで迷っているなら、そのエージェントがチャットウィンドウであなたと対話するのか（MCP）、シェルやパイプラインで無人実行されるのか（CLI）を考えてみてください。

クイックスタート：インストール、ログイン、生成

macOSまたはLinuxでは、インストーラーを実行します。

curl -fsSL https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.sh | sh

Windows ユーザーは、代わりに PowerShell インストーラーを実行できます。

irm https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.ps1 | iex

次に、ログインコマンドで開かれたブラウザウィンドウから認証を行います。

openart login

現在の画像モデルを見つけて、その識別子をコピーします。

openart model list

下記コマンドのモデルを、そのリスト内の識別子（例）に置き換えてください nano-banana-2。最初のリクエストは次でプレビューできます --dry-run ので、OpenArtはクレジットを消費しません。

openart generate image "A small red sailboat on a calm lake at sunrise" \
  --model nano-banana-2 \
  --dry-run

プレビューを確認したら、次を削除してください --dry-run 生成をサブミットします。

openart generate image "A small red sailboat on a calm lake at sunrise" \
  --model nano-banana-2

よくある質問

OpenArt CLI とは？

OpenArt CLIは、ターミナルから画像や動画を生成する単一のバイナリです。ブラウザベースのOAuthを通じてOpenArtアカウントに接続し、スクリプト、バッチジョブ、CIタスク、そしてシェルアクセスを持つコーディングエージェントで利用できます。

OpenArt CLIのインストールは無料ですか？

CLIのインストール自体に費用はかかりません。画像・動画の生成には、Webアプリと同様に、OpenArtアカウントとプランで利用できるクレジットが使われます。次を実行します openart model cost を実行して、生成前に各モデルの料金を確認できます。

OpenArt CLIにAPIキーは必要ですか？

いいえ。 openart login OpenArtアカウント用にブラウザベースのOAuthサインインが開くため、ローカル設定に別のシークレットを保存したりローテーションしたりする必要はありません。

OpenArt CLIはどのプラットフォームに対応していますか？

macOS、Linux、Windowsに対応し、次を通じてスタンドアロンのバイナリとして配布されます 公式GitHubリポジトリ。PythonやNodeのインストールは不要です。

CLIとMCP、どちらを使うべき？

作業がすでにターミナルで行われている場合はCLIを使いましょう。シェルスクリプト、CIパイプライン、あるいはClaude CodeやCodexのようなシェルアクセスを持つコーディングエージェントなどです。OpenArtの次を使いましょう MCPサーバー Claude、ChatGPT、Cursorでチャットベースのエージェントを使い、会話の途中で画像や動画を生成・調整したいときは、次のように Claudeから直接プロダクト広告を生成。両者は排他的なものではなく、繰り返し行う部分をCLIでスクリプト化し、探索的な部分にMCPを使うチームもあります。

OpenArt CLIはWebアプリとどう違いますか？

CLIは、生成やアカウント操作を、構造化された出力、ドライラン、非同期のジョブ処理を備えたコマンドとして提供します。Webアプリは、インタラクティブな制作・編集のためのビジュアルなインターフェースを提供します。UIをクリックして操作するのではなく、繰り返し使えるシェルコマンドや自動化が必要なときはCLIを選びましょう。

OpenArt CLIをアンインストールするには？

組み込みのアンインストールコマンドはないため、バイナリと保存された認証情報を手動で削除してください。次を実行します rm "$(command -v openart)" と rm -rf ~/.openart （macOSまたはLinuxの場合）、または次を削除します %LOCALAPPDATA%\Programs\openart と %USERPROFILE%\.openart （Windowsの場合）。