XinYu AI コマンドラインツール
ターミナルや CI から、画像・動画・音声・テキストを生成したり、キャンバスを整理したりできます。使われるのはご自身のアカウントと残高です。バイナリは xinyu の 1 つだけで、MCP サーバー(xinyu mcp)も内蔵しています。
概要
xinyu CLI は、XinYu AI の生成 API を包む軽量なラッパーです。ユーザー単位の API キーで認証し、料金は Web 版とまったく同じです。スクリプト、自動化、CI パイプラインに向いています。
--json の出力は stdout、進捗は stderr に出るので、そのまま | jq に渡せます。
生成はプラットフォーム側で非同期に実行されます。待機がタイムアウトしても、job wait / job get で取得できます。
xinyu mcp は、エージェント向けの MCP サーバーとしてそのまま使えます。
API キーを取得する
XinYu AI にログイン
「設定」→「開発者 API キー」を開く
キーを作成してコピー
インストール
# Install the `xinyu` command globally
npm install -g @xinyuai/cli
# …or run any command without installing:
npx @xinyuai/cli <command>ログイン
ログインではサーバーでキーを検証し、認証情報を ~/.xinyu/credential.json(権限 600)に保存します。
# 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 Audioxinyu 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 サーバーを起動よく使うオプション
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`.使用例
# 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"非同期とタイムアウト(結果は失われません)
生成はプラットフォーム側で非同期に実行され、CLI が待機しているかどうかとは無関係です。--timeout が制御するのは、CLI がローカルで待つ時間だけです。既定値は、画像・音声系のコマンドが 300 秒、動画系のコマンド(generate video / final / video-edit / video-action)が 2400 秒(40 分)、job wait が 600 秒です。約 60 分間出力のないジョブは、プラットフォームが失敗と判定して返金するので、--timeout は 3600 秒(60 分)まで指定すれば十分です。
$ 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 クライアントに公開します。
{
"mcpServers": {
"xinyu": {
"command": "xinyu",
"args": ["mcp"]
}
}
}MCP 接続の詳しい手順は MCP ガイド をご覧ください。