Imagifly logoImagifly開発者ドキュメント
エージェント

CLI

Imagifly CLI を入れてログインし、ターミナルから画像や動画を生成します。

Imagifly CLI は、ウェブサイトと同じアカウント、クレジット、モデルを使うコマンドラインツールです。インストール後は、自分でターミナルから生成することも、Cursor や Claude Code などの Agent に任せることもできます。

Node.js 18 以上が必要です。

インストール

npm install -g @imagifly/cli
imagifly --help

ログイン

imagifly auth login --agent Cursor

ブラウザで許可画面が開きます。Imagifly にログインして「許可」を押してください。--agent は使っているツール名に変えます。Claude Code や Codex のように書くと、許可画面にその名前が出ます。

ログインに成功すると、トークンはこのコンピュータに保存されます。他人に渡さないでください。許可したツールは Skill コンソール で確認・取り消しできます。

imagifly auth status
imagifly auth logout

ログインが有効か確認するには:

imagifly +me

終了コード 0 ならログイン済みです。

Agent にインストールを任せたい場合は、次の文を送ってください。

https://imagifly.net/cli/setup.ja.md を読み、手順に従って Imagifly CLI をインストールして設定してください。

コマンド

コマンド内容
imagifly auth login --agent <name>ブラウザを開いてログインする
imagifly auth logoutログアウトする
imagifly auth statusログイン状態を見る
imagifly +meログインが有効か確認する
imagifly credits現在のクレジット残高を見る
imagifly models image画像モデルを一覧する
imagifly models video動画モデルを一覧する
imagifly image generate --prompt "..." --model <id>画像を生成する
imagifly image history最近の画像生成を見る。各回の消費クレジットを含む
imagifly image get --id gen_...画像タスクを確認する。結果の generation.cost が消費クレジット
imagifly video generate --prompt "..." --model <id>動画を生成する
imagifly video get --id vid_...動画タスクを確認する

モデル名、料金、比率、長さは models image / models video の結果を使ってください。

成功すると、ターミナルに JSON が 1 行出ます。進捗やヘルプは別の出力なので、普段は無視して構いません。

画像を生成する

モデルを見てから生成します。

imagifly models image
imagifly image generate --prompt "夕暮れの雨の茶屋" --model <id> --ratio 16:9 --wait --out tea.png

よく使うフラグ:--quality high、--resolution-tier 1k、--steps 20、--reference file.png(繰り返し可)。--wait は完成または失敗まで待ちます。--out は --wait と一緒に使い、最初の画像を保存します。

タスク ID がすでにある場合:

imagifly image get --id gen_... --out tea.png

動画を生成する

imagifly models video
imagifly video generate --prompt "雨の茶屋を 5 秒歩く" --model <id> --duration 5s --wait --out clip.mp4

--duration はそのモデルが対応する長さ(5s など)にしてください。モデルによっては --variant、--fps、--size、--ratio、--first-frame、--last-frame も使えます。

失敗したとき

終了コード意味
0成功。生成中のタスクを確認した場合も 0
2引数が正しくない
3未ログイン、またはログイン切れ
4生成失敗、または待ち時間切れ
1ネットワークなど予期しないエラー

失敗時の JSON には error と message が入っています。クレジット不足や拒否は error を見てください。タスクが受け付けられた時点でクレジットは予約されます。途中でターミナルを閉じた場合は、同じタスク ID を確認し、やり直さないでください。失敗したタスクのクレジットは返還されます。

同じ機能は HTTP API や MCP からも使えます。

このページの内容