npm install -g pixshop

Pixshop CLI

在终端中使用 AI 创意平台

从命令行生成图片、视频，使用 48+ AI 工具。通过 npm 安装即可开始创作。

$ pixshop --version
pixshop v1.1.0

$ pixshop generate -p "a cute cat in space" -o cat.png
✓ Image generated!

  Model              nano-banana
  Processing Time    3200ms
  Credits Used       1
  Credits Remaining  49

✓ Image saved to cat.png

安装

1通过 npm 全局安装

npm install -g pixshop

2登录你的账号

pixshop login

3开始创作

pixshop generate -p "your creative prompt" -o output.png

更新

更新到最新版本

npm install -g pixshop@latest

命令列表

认证

pixshop login登录 Pixshop 账号

pixshop logout移除已存储的凭证

pixshop whoami显示当前用户信息

创作

pixshop generateAI 图片生成

pixshop videoAI 视频生成

pixshop apps浏览 Nano Banana 应用

pixshop prompts浏览提示词库

pixshop toolsAI 工具（换脸、超分、试穿...）

管理

pixshop credits查看积分余额和用量

pixshop projects管理 Agent 项目

pixshop discover查看 AI 工具目录

pixshop config管理 CLI 配置

使用示例

生成图片

$ pixshop generate -p "sunset over mountains" -o sunset.png

指定模型和比例

$ pixshop generate -p "anime girl" --model nano-banana --aspect-ratio 9:16

从图片生成视频

$ pixshop video -i photo.jpg -p "add gentle motion" -o animated.mp4

放大图片

$ pixshop tools upscale -i photo.jpg -o photo-hd.jpg

换脸

$ pixshop tools face-swap -i face.jpg --image2 target.jpg -o result.jpg

虚拟试穿

$ pixshop tools try-on -i person.jpg -p "blue jacket" -o tryon.jpg

浏览推荐应用

$ pixshop apps --category generation --featured

搜索提示词

$ pixshop prompts -s "cyberpunk" --type image

查看余额

$ pixshop credits

JSON 输出用于脚本

$ pixshop apps --json | jq '.data.apps[].name'

全局选项

Flag	Description
`--help, -h`	显示帮助
`--version, -v`	显示版本
`--json`	JSON 格式输出（适合脚本）
`--api-url <url>`	覆盖 API 地址
`--no-color`	禁用彩色输出

配置

配置文件存储在 ~/.pixshop/config.json

# Set API URL for local development
pixshop config set api-url http://localhost:3000

# Set default locale
pixshop config set locale zh

# View all config
pixshop config

系统要求

Node.js

需要 Node.js 18 或更高版本

node --version  # v18.0.0+

Pixshop 账号

需要 Pixshop 账号（注册赠送免费积分）

注册账号

常见问题

CLI 是免费的吗？

CLI 工具本身免费开源。AI 操作会消耗你 Pixshop 账号的积分（注册即赠送免费积分）。

可以在 CI/CD 流水线中使用吗？

可以！使用 --json 标志获取机器可读输出。可通过环境变量或预配置凭证进行认证。

支持哪些 AI 模型？

所有 Web 平台上的模型都可通过 CLI 访问，包括 Nano Banana、Flux、Seedance 等。

支持 Windows 吗？

支持，CLI 可在 macOS、Linux 和 Windows 上运行，需要 Node.js 18 或更高版本。

准备好了吗？

一行命令安装，开始你的 AI 创作之旅。

npm install -g pixshop