@jingoz/imagen

Cloudflare Image Worker 的命令行工具，提供 t2i / i2i / admin / config 全流程能力。

安装与运行

# 直接运行
npx @jingoz/imagen --help

# 全局安装
npm i -g @jingoz/imagen
imagen --help

快速开始

1) 写入基础配置

imagen config set base_url https://imagen.zhj13.top
imagen config set api_key cfiwk_xxx
imagen config set admin_api_key admin_xxx
imagen config set download_dir ./images
imagen config set output pretty

2) 查看配置（密钥会自动掩码）

imagen config list
imagen config list --json

3) 文生图

imagen t2i --prompt "a cyberpunk cat" --steps 4 --guidance 6.5
imagen t2i --prompt "a cyberpunk cat" --no-download --json

4) 图生图

imagen i2i --image ./input.png --prompt "oil painting style" --strength 0.5
imagen i2i --image ./input.png --prompt "oil painting style" --no-download --json

5) 管理员密钥管理

imagen admin key create --scope generate:t2i --scope generate:i2i --rpm 120
imagen admin key get --key-id key_xxx --json
imagen admin key revoke --key-id key_xxx

环境变量优先级

运行时优先级：命令行参数 > 环境变量 > 配置文件 > 默认值

• IMAGEN_BASE_URL
• IMAGEN_API_KEY
• IMAGEN_ADMIN_API_KEY
• IMAGEN_DOWNLOAD_DIR
• IMAGEN_OUTPUT
• IMAGEN_TIMEOUT
• IMAGEN_REQUEST_ID

本地开发

npm ci
npm run lint
npm run typecheck
npm test
npm run build

发布前检查（建议）

npm run lint
npm run typecheck
npm test
npm run build
npm pack --dry-run

npm pack --dry-run 应只包含 dist/ 与必要的包元信息文件。