XinYu AI Command-Line Tool

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

# …or run any command without installing:
npx @xinyuai/cli <command>

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

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 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 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 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>]

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...>

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 --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 --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"

$ 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

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