JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 11
  • Score
    100M100P100Q104471F
  • License MIT

Ti-Pic-Cli — AI 生图终端工具，一行命令出图

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@karelx/ti-pic-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    @karelx/ti-pic-cli

    AI 生图终端工具 · 一行命令出图

    npm install -g @karelx/ti-pic-cli
tpc gen "一只橘猫在阳光下打盹"

    ✨ 特性

    • 一行命令出图 — 输入提示词，自动生成并下载到本地
    • 多模型可选 — 支持 GPT Image、Nano Banana 等多个 AI 模型
    • 零配置 — 首次运行自动注册设备，赠送免费次数，即装即用
    • 卡密充值 — 免费次数用完后，用卡密激活获取更多次数
    • 本地历史 — 生图记录自动保存，随时回查

    📦 安装

    # 全局安装（推荐）
npm install -g @karelx/ti-pic-cli

# 或免安装直接用
npx @karelx/ti-pic-cli gen "提示词"

    系统要求：Node.js >= 20

    🎯 快速开始

    # 1. 自检环境（可选）
tpc doctor

# 2. 直接出图（首次运行自动注册 + 赠送免费次数）
tpc gen "一只橘猫在阳光下打盹"

# 3. 指定模型和比例
tpc gen "赛博朋克街景" -m nano-banana-fast -r 16:9

# 4. 查看可用模型
tpc models

    📖 命令总览

    生图

    tpc gen <prompt>                       # 生成图片
  -m, --model <name>                   # 模型（默认 gpt-image-2）
  -r, --ratio <a:b>                    # 比例（1:1 / 3:4 / 4:3 / 16:9 / 9:16）
  -s, --size <size>                    # 图像尺寸（Nano 系：1K / 2K / 4K）
  -n, --count <num>                    # 批量张数（最多 4）
  -o, --out <dir>                      # 输出目录（默认 ./output）
  --seed <n>                           # 随机种子
  --no-download                        # 只返回 URL，不下载到本地

    查询

    tpc models                             # 列出可用模型
tpc credits                            # 查询剩余次数
tpc history list [-n 20]               # 最近 N 条生图记录
tpc history show <id>                  # 单条详情
tpc history clear --yes                # 清空历史
tpc doctor                             # 环境自检

    充值

    tpc activate TPC-XXXX-YYYY-ZZZZ       # 激活卡密，获取更多次数

    配置

    tpc config get [key]                   # 查看配置
tpc config set <key> <value>           # 修改配置
tpc config reset [key]                 # 恢复默认
tpc config path                        # 配置文件路径

    可配置项：

    配置项 默认值 说明
    tpcServerUrl https://tpc.aigcmax.club 服务端地址
    defaultModel gpt-image-2 默认模型
    defaultRatio 1:1 默认比例
    defaultImageSize 1K 默认尺寸（Nano 系）
    outDir ./output 默认输出目录

    全局选项

    --data-dir <path>    指定数据目录（或环境变量 TPC_DATA_DIR）
--no-banner          关闭启动 logo
--no-color           关闭终端色彩
-v, --verbose        详细日志
--json               JSON 输出（脚本友好）

    🗂️ 数据目录

    默认走 OS 标准目录：

    平台 默认路径
    Windows %APPDATA%\ti-pic-cli-nodejs\Config\
    macOS ~/Library/Preferences/ti-pic-cli-nodejs/
    Linux ~/.config/ti-pic-cli-nodejs/

    自定义位置（优先级：CLI 参数 > 环境变量 > 默认）：

    # CLI 参数（一次性）
tpc --data-dir ./my-data gen "test"

# 环境变量（长期生效）
$env:TPC_DATA_DIR = "D:\tpc-data"    # PowerShell
export TPC_DATA_DIR=/opt/tpc-data     # bash

    运行 tpc doctor 可查看当前数据目录路径。

    📜 License

    MIT © Ti