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 を確認し、やり直さないでください。失敗したタスクのクレジットは返還されます。
