公式CLI · npmのmodellix-cli

Modellix CLI

すべてのModellixモデルを、ターミナルからエージェントまで

認証、100種類以上の画像・動画モデルの検索、非同期ジョブの実行、機械可読な--json出力とスクリプト、CI、Cursor、Claude Code、Codexとの連携に対応した公式コマンドラインクライアントです。

npm install --global modellix-cli

Node.js 18.17以降が必要です。インストール後、modellix-cli --versionを実行して確認してください。

npmからインストールCLIガイドを読むGitHubで見る

クイックスタート

3つのコマンドで開始

Modellix CLIはAPIと同じ非同期ワークフローを採用しています。ジョブを送信してtask_idを受け取り、完了するまでポーリングまたは待機します。

  1. 01 · インストール

    グローバルインストール

    一度インストールすれば、どのターミナルからでも利用できます。Node.js 18.17以降が必要です。

    npm install --global modellix-cli
  2. 02 · 認証

    APIキーを保存

    対話形式のログインでキーを検証してからローカルに保存します。最初にModellixコンソールでキーを取得してください。

    コンソール → APIキー
    modellix-cli init
  3. 03 · 検索

    モデルを選択

    利用可能な画像・動画モデルを確認し、model runでジョブを送信します。1つのコマンドで最終結果まで取得する場合は--waitを追加します。

    modellix-cli model list

機能

開発者、スクリプト、エージェント向けに設計

予測可能な自動化フラグ、ローカルのタスク履歴、APIキーを出力しない診断機能を提供します。

  • すべてのモデルを検索

    model listでカタログを検索・絞り込み、model describeで入力仕様を確認できます。--jsonを追加すると、エージェントが読み取れる結果を取得できます。

  • 一貫した実行ワークフロー

    model run（別名model invoke）に--bodyまたは--body-fileを指定してジョブを送信し、task getまたはtask waitで進行状況を確認します。

  • バッチ送信とダウンロード

    同時実行数を制御してJSONLバッチを送信し、task downloadで出力をローカルに保存します。機械可読な出力により、一時的な署名付きダウンロードURLの露出を防ぎます。

  • エージェント対応の出力

    --jsonと--quietによりstdoutを安定させます。文書化された終了コードはCIと相性がよく、警告と復旧手順はstderrに出力されます。

  • 自動化の前に診断

    modellix-cli doctorはNode.jsのバージョン、APIキーの参照元、ネットワーク接続、チーム残高を検査します。APIキー自体は表示しません。

  • チーム向けの複数プロファイル

    複数の認証プロファイルを保存し、シェル履歴にキーを残すことなく--profileまたはMODELLIX_PROFILEで切り替えられます。

ターミナルワークフロー

実際のCLIセッション

モデルカタログを参照し、ジョブを送信して機械可読な結果を取得する、標準的な開発ワークフローです。

~/projects/marketing · modellix-cli
# 1. モデルカタログを参照$ modellix-cli model list --type text-to-image --output slugs# 2. ジョブを送信$ modellix-cli model run \
  --model-slug bytedance/seedream-5.0-pro \
  --body '{"prompt":"日当たりの良い庭で遊ぶかわいい猫"}'# 3. 結果を取得（またはmodel runに--waitを追加）$ modellix-cli task get task-abc123 --json# 出力例 → { "code": 0, "data": { "status": "success", "task_id": "task-abc123", ... } }

エージェント連携

コーディングエージェントと連携

追加のデーモンは不要です。シェルコマンドを実行できる任意のエージェントからmodellix-cliを直接呼び出せます。model runの後にtask getを実行し、別のプログラムが出力を処理する場合は必ず--jsonを追加してください。

Cursor、Claude Code、Codex、およびターミナルツールを利用できる任意のエージェントに対応します。

自動化の前に環境を確認
modellix-cli doctor --json

サポート

よくある質問

インストール、認証、自動化、課金に関する回答です。

Modellix CLIとは何ですか？

Modellix CLIはmodellix-cliパッケージとして公開されているModellix公式のコマンドラインクライアントです。認証の管理、AI画像・動画モデルの検索と実行、非同期ジョブの完了待機、出力のダウンロードに対応し、スクリプトやコーディングエージェント向けに安定したJSONを出力します。

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

Node.js 18.17以降が必要です。npm install --global modellix-cliを実行し、modellix-cli --versionでインストールを確認してください。引数なしでmodellix-cliを実行するとローカルのクイックスタートが表示され、APIは呼び出されません。

modellix-cliで認証するには？

ModellixコンソールでAPIキーを取得し、modellix-cli initまたはmodellix-cli auth loginを実行します。CIではMODELLIX_API_KEYを設定するか、--api-keyと--yesを併用してください。キーをシェル履歴に残さないよう、環境変数または非表示の入力プロンプトを推奨します。

Modellix CLIで画像を生成するには？

最初にmodellix-cli model listでモデルを探します。次に、プロバイダー/モデルのslugとプロンプト本文を指定してmodellix-cli model runを実行します。modellix-cli task getで結果を取得するか、model runに--waitを追加します。

コーディングエージェントからModellix CLIを利用できますか？

はい。--jsonと--quietにより、シェルコマンドを実行できるCursor、Claude Code、Codexなどのエージェントでstdoutを安定して処理できます。処理結果はstdout、診断情報と復旧手順はstderrに出力されます。

Modellix CLIはREST APIの代わりになりますか？

いいえ。CLIは同じModellix REST APIを使用し、ターミナルと自動化向けに設計されています。カスタムHTTPクライアントが必要な場合はREST、認証管理、モデル検索、ジョブの完了待機、ダウンロード、エージェント向け出力が必要な場合はCLIを利用してください。

CLIジョブはどのように課金されますか？失敗したリクエストを再試行してもよいですか？

CLIジョブにはREST APIジョブと同じモデル料金が適用されます。送信済みのジョブには料金が発生する場合があるため、タイムアウトやネットワークエラーの後に無条件で再試行しないでください。タスクIDを受け取っている場合は、ジョブを再送信する前にステータスを確認してください。

Modellix CLI

CLIをインストールして開発を開始

npmからインストールし、一度認証すれば、ターミナルから任意のModellixモデルを実行できます。同じコマンドをエージェントに実行させることもできます。

npmからインストールAPIキーを取得CLIドキュメントを読む