XinYu.
ナビゲーション
開発者
MCPCLI
言語
CLI

XinYu AI コマンドラインツール

ターミナルや CI から、画像・動画・音声・テキストを生成したり、キャンバスを整理したりできます。使われるのはご自身のアカウントと残高です。バイナリは xinyu の 1 つだけで、MCP サーバー(xinyu mcp)も内蔵しています。

概要

xinyu CLI は、XinYu AI の生成 API を包む軽量なラッパーです。ユーザー単位の API キーで認証し、料金は Web 版とまったく同じです。スクリプト、自動化、CI パイプラインに向いています。

パイプ対応

--json の出力は stdout、進捗は stderr に出るので、そのまま | jq に渡せます。

非同期でも失われない

生成はプラットフォーム側で非同期に実行されます。待機がタイムアウトしても、job wait / job get で取得できます。

MCP を内蔵

xinyu mcp は、エージェント向けの MCP サーバーとしてそのまま使えます。

前提条件:Node.js 18 以上と XinYu AI アカウント。

API キーを取得する

1

XinYu AI にログイン

xinyuai.app にアクセスして、アカウントにログインします。
2

「設定」→「開発者 API キー」を開く

右上のアバターをクリックして「設定」を選び、ページの下のほうにある「開発者 API キー」を探します。
3

キーを作成してコピー

キーの名前を入力して「キーを作成」をクリックします。平文のキー(xys_live_...)は一度しか表示されないので、すぐにコピーして保管してください。スクリプトに照会だけさせて Xinポイントを使わせたくない場合は、作成前に「読み取り専用キー(照会のみ、生成は不可)」にチェックを入れます。
API キーはアカウントと同等の権限を持ち、Xinポイントを消費できます。リポジトリにコミットしたり、公開したりしないでください。漏えいした場合は、すぐに同じ場所で無効化してください。

インストール

bash
# Install the `xinyu` command globally
npm install -g @xinyuai/cli

# …or run any command without installing:
npx @xinyuai/cli <command>
Node.js 18 以上が必要です。インストール後は、xinyu コマンドをどこからでも使えます。

ログイン

ログインではサーバーでキーを検証し、認証情報を ~/.xinyu/credential.json(権限 600)に保存します。

bash
# Pass --key directly, or omit it to be prompted
xinyu login --key xys_live_xxxxxxxxxxxx --base-url https://xinyuai.app

ログインせずに、環境変数 XINYU_API_KEY / XINYU_BASE_URL を使うこともできます(こちらが優先され、CI で便利です)。

コマンド

アカウントとモデル

xinyu loginAPI キーを保存して検証
xinyu logout保存済みの認証情報を削除
xinyu whoami現在のログイン先を表示
xinyu balanceXinポイント残高を表示
xinyu model listモデルを一覧表示(種類で絞り込み可)
xinyu price実行前に画像生成の料金を見積もる(画像のみ)。実際の課金と同じ関数で計算します
xinyu presets心宇プリセット(衣装 1407 点・人形ポーズ 288 種)を分類・アングル・番号で絞り込み
xinyu preset-importプリセットを自分の素材として保存し、参照画像に使える URL を取得(プリセットの元 URL はそのまま参照に使えません・無料)

プロジェクトとファイル

xinyu project list自分のプロジェクト(キャンバス)を一覧表示し、--project に渡す id を確認
xinyu project create空のキャンバスを新規作成し、id を返す
xinyu project assetsキャンバス上の素材を検索・一覧表示し、再利用できる URL を取得(-q でタイトルとプロンプト全文を検索)
xinyu project readキャンバスの概要:ノードと接続の総数、タイプ別の件数
xinyu project arrangeキャンバスを整理:散らばったコンテンツノードをグリッドに並べる
xinyu project delete空のキャンバスを削除(ノード・生成結果なし)。内容があるキャンバスは Web 上で削除
xinyu uploadローカルの画像・動画・音声をアップロードして、生成に使える URL を表示(--place でキャンバスにも配置)

生成と編集

xinyu generate imageテキストから画像 / 画像から画像
xinyu generate videoテキストから動画 / 画像から動画 / 参照から動画
xinyu generate finalSeedance 2.5 のドラフトから 1080p または 4K の本番動画を生成
xinyu generate audioテキスト読み上げ / Seed Audio
xinyu generate textテキスト LLM を実行
xinyu generate enhance画像の高解像度化と高画質化(Topaz)
xinyu generate rembg背景除去(透過 PNG)
xinyu generate layersベース + 透過 PNG レイヤーに分解(上限分を先に引き落とし、未使用分は返金)
xinyu generate outpaintアウトペイント:画像を任意の辺にピクセル単位で拡張
xinyu generate image-edit指示による画像編集(描き直し・消去)
xinyu generate video-edit指示による動画編集(Kling O3。元動画は高さ 720px 以上)
xinyu generate video-action以前に生成した Grok 動画を高解像度化・延長

キャンバスのノード

xinyu node create生成せずにノードを追加(プロンプト・モデル・パラメータ・参照を設定、クレジット消費なし)
xinyu node findタイトル / プロンプト、種類、状態、グループ、位置でノードを検索(読み取り専用)
xinyu node inspect最大 8 ノードの詳細:プロンプト、パラメータ、URL、接続、revision(読み取り専用)
xinyu node read-promptノードの完全なプロンプトを分割して読み取る(読み取り専用)
xinyu node renameキャンバスのノードのタイトルを変更
xinyu node connect2 つのノードの間に参照の接続を引く
xinyu node disconnectノード間の参照の接続を削除
xinyu node deleteノードとその接続を削除(元に戻せません。生成済み・生成中のノードは --confirm-* が必要)
xinyu node set-paramsノードの生成パラメーターをその場で変更(下書きのみ。再生成もポイント消費もありません)

ジョブと MCP

xinyu job getジョブのステータスと成果物を取得
xinyu job waitジョブが終わるまで待つ(待機タイムアウト後の取得に最適)
xinyu job list最近のジョブを一覧表示(ステータス・キャンバスで絞り込み可)
xinyu mcp内蔵の MCP サーバーを起動

よく使うオプション

bash
xinyu login [--key <key>] [--base-url <url>]
xinyu logout
xinyu whoami
xinyu balance [--json]
xinyu model list [--type IMAGE|VIDEO|AUDIO] [--json]
xinyu price --model <m> [--size <s>] [--count <n>] [--refs <n>] [--json]
xinyu presets [--group clothing|pose] [--category <c>] [--angle <a>] [-q <text>]
              [--offset <n>] [--limit <n>] [--json]
xinyu preset-import <presetUrl> [--project <id>] [--place] [--json]

xinyu project list    [--search <text>] [--limit <n>] [--json]
xinyu project create  --name <name> [--description <text>] [--json]
xinyu project assets  <projectId> [-q <text>] [--type IMAGE|VIDEO|AUDIO]
                      [--page <n>] [--limit <n>] [--json]
xinyu project read    <projectId> [--limit <n>] [--json]
xinyu project arrange <projectId> [--columns <n>] [--gap <n>] [--json]
xinyu project delete <projectId> [--json]   # empty canvases only
xinyu upload <file> [--project <id>] [--place] [--json]

xinyu generate image --prompt <p> --project <id> [--model <m>] [--aspect <r>]
                     [--size <s>] [--ref <url...>] [--count <n>] [--x <n>] [--y <n>]
                     [--no-place-on-canvas] [--no-wait] [--timeout <s>] [--json]
xinyu generate video --prompt <p> --project <id> [--model <m>] [--duration <s>]
                     [--resolution <r>] [--audio] [--start-image <url>] [--end-image <url>]
                     [--element-image <url...>] [--ref-video <url...>] [--ref-audio <url...>]
                     [--draft] [--x <n>] [--y <n>] [--no-place-on-canvas]
                     [--no-wait] [--timeout <s>] [--json]
xinyu generate final <draftJobId> --project <id> [--resolution <r>]
                     [--no-wait] [--timeout <s>] [--json]
xinyu generate audio --text <t> --project <id> [--model <m>] [--voice <v>] [--no-wait] [--json]
xinyu generate text  --prompt <p> [--model <m>] [--media <url...>] [--project <id>] [--json]

xinyu generate enhance      --image <url> --project <id> [--upscale-factor <n>]
                            [--no-face-enhancement]
xinyu generate rembg        --image <url> --project <id> [--mask]
xinyu generate layers       --image <url> --project <id> [--max <n>] [--size 1K|2K] [--text]
xinyu generate outpaint     --image <url> --project <id> [--top <n>] [--right <n>]
                            [--bottom <n>] [--left <n>]
xinyu generate image-edit   --prompt <t> --image <url> --project <id> [--model <m>] [--mode <m>]
xinyu generate video-edit   --prompt <t> --video <url> --project <id>
                            [--duration <s>] [--keep-audio]
xinyu generate video-action --action <a> --source-task-id <id> --project <id>
                            [--extend-times <n>]
# Results land on the canvas by default. All commands above except text accept:
#   [--title <text>] [--x <n>] [--y <n>] [--no-place-on-canvas]

xinyu node create <image|video|audio|text> --project <id> [--prompt <t>] [--model <m>]
                  [--title <t>] [--set <key=value...>] [--ref <nodeId...>]
xinyu node find --project <id> [-q <text>] [--type <t...>] [--status <s>]
xinyu node inspect <nodeId...> --project <id>
xinyu node read-prompt <nodeId> --project <id> [--offset <n>]
xinyu node rename <nodeId> --project <id> --title <title>
xinyu node connect <sourceId> <targetId> --project <id>
xinyu node disconnect <sourceId> <targetId> --project <id>
xinyu node delete <nodeId...> --project <id> [--confirm-finished] [--confirm-running]
xinyu node set-params <nodeId> --project <id> --set <key=value...> [--confirm-finished] [--confirm-running]

xinyu job get  <jobId> [--json]
xinyu job wait <jobId> [--timeout <s>] [--json]
xinyu job list [--status <s>] [--project <id>] [--limit <n>] [--json]

xinyu mcp

# --project is required for every generate command except `generate text`:
# every result belongs to a canvas. Get an id with `xinyu project list`
# or `xinyu project create`. Run `xinyu <command> --help` for every flag.
# Valid values for --size / --duration / --resolution depend on the model:
# see `xinyu model list --json`.

使用例

bash
# Create (or pick) a canvas first — every generation needs one
PID=$(xinyu project create --name "My Canvas" --json | jq -r '.id')

# Ask what an image would cost before spending anything
xinyu price --model nano-banana-2.1 --size 2K --count 2

# Grab a generated image URL in CI (clean JSON on stdout)
URL=$(xinyu generate image --prompt "a beach at sunset" \
        --model nano-banana-2.1 --size 2K --project "$PID" --json | jq -r '.assets[0]')

# Upload a local image, then animate it as the first frame
IMG=$(xinyu upload ./character.png)
xinyu generate video --prompt "she turns and smiles" --model seedance-2 \
        --start-image "$IMG" --duration 5 --project "$PID"

# Lost the id after a timeout? Find the job, then wait for it
xinyu job list --status RUNNING --project "$PID"
xinyu job wait <jobId>

# Ask an LLM
xinyu generate text --prompt "summarize MCP in one sentence"
生成系コマンドは、デフォルトではジョブの完了を待って、成果物の URL を stdout に出力します。--no-wait を付けると jobId をすぐに返すので、あとで xinyu job wait または xinyu job get で取得できます。generate は gen、project は canvas と書くこともできます。node 系コマンド(タイトル変更・接続・削除・パラメーター変更)は個人キャンバスのみ対応で、チームキャンバスは拒否されます。

非同期とタイムアウト(結果は失われません)

生成はプラットフォーム側で非同期に実行され、CLI が待機しているかどうかとは無関係です。--timeout が制御するのは、CLI がローカルで待つ時間だけです。既定値は、画像・音声系のコマンドが 300 秒、動画系のコマンド(generate video / final / video-edit / video-action)が 2400 秒(40 分)、job wait が 600 秒です。約 60 分間出力のないジョブは、プラットフォームが失敗と判定して返金するので、--timeout は 3600 秒(60 分)まで指定すれば十分です。

bash
$ xinyu generate video --prompt "..." --model seedance-2 --project "$PID" --timeout 1200
Job 7f3a… queued (40 Xins) — waiting...
Stopped waiting after 1200s — the job is STILL RUNNING and you have already paid 40 Xins for it.
Do not run the generate command again; resume it instead:
  xinyu job wait 7f3a…          # blocks until it finishes
  xinyu job list --status RUNNING  # if you lost the id

待機のタイムアウトはエラーではありません。CLI は jobId と再開方法を表示して終了し、ジョブはサーバー側で実行を続けます。xinyu job wait で待ち続けるか、xinyu job get で 1 回確認できます。id を失くしたときは xinyu job list --status RUNNING で探せます。完了すると成果物はアカウントに保存されます(--project を指定した場合は該当キャンバスのプロジェクトにも入ります)。料金は作成時に差し引かれ、ジョブが失敗した場合は自動で返金されます。長時間(約 60 分以上)出力のないジョブも、プラットフォームが自動で失敗と判定して返金します。二重に課金されることも、成功した結果が失われることもありません。待機がタイムアウトしても、generate コマンドを再実行しないでください。

MCP サーバーとして使う

xinyu mcp は、保存済みの認証情報を使って stdio の MCP サーバーとして起動し、MCP ページに載っているすべてのツール(生成・編集・ジョブ・キャンバスの参照と編集)をあらゆる MCP クライアントに公開します。

json
{
  "mcpServers": {
    "xinyu": {
      "command": "xinyu",
      "args": ["mcp"]
    }
  }
}

MCP 接続の詳しい手順は MCP ガイド をご覧ください。

よくある質問