aigc-cli

README

一个 CLI，通吃 OpenAI、OpenRouter 及任意 OpenAI 兼容中转服务。

不只是 API 转发——智能适配各平台专有 API，完整覆盖图片/视频/Midjourney/AI 对话/提示词灵感，自带 MCP Server 和 Agentic Chat。

---

为什么选 aigc-cli？

🤖	MCP Server	接入 Claude Desktop、Cursor 等 AI 客户端，对话中直接生成图片视频、搜索灵感库、查询模型定价，无需切工具。
🔬	AIGC 检测引擎	离线多信号融合：C2PA Content Credentials、TC260（国标 GB 45438-2025）、SynthID 隐形水印、ONNX 模型推理、FFT 频谱分析、SRM 噪声残差、JPEG 量化检测。全部本地运行，无需 API Key。
🔌	多 Provider 统一入口	改一个 base_url 在 OpenAI / OpenRouter / 任意中转之间切换，命令完全不变，Provider 自动适配。

---

快速开始

安装

从 Releases 页面 下载对应平台的二进制文件。

使用 OpenAI

export OPENAI_API_KEY="sk-xxx"

aigc-cli image --prompt "一只猫在星空下"
aigc-cli chat --message "你是谁？"

使用 OpenRouter（改环境变量，命令不用动）

export OPENAI_API_KEY="sk-or-xxx"
export OPENAI_BASE_URL="https://openrouter.ai/api/v1"

aigc-cli image --model "openai/gpt-image-2" --prompt "a cat"
aigc-cli video --model "google/veo-3.1" --prompt "a dog running"     # 自动走专用视频 API
aigc-cli models --type image                                           # 免认证模型发现

使用任意 OpenAI 兼容中转

export OPENAI_API_KEY="sk-xxx"
export OPENAI_BASE_URL="https://your-relay.com/v1"

aigc-cli chat --message "Hello"

MCP 集成（推荐）

在 Claude Desktop / Cursor / Windsurf 的 MCP 配置中添加：

{
  "mcpServers": {
    "aigc-cli": {
      "command": "aigc-cli",
      "args": ["mcp"]
    }
  }
}

AI 代理可以在对话中直接生成图片、创建视频、搜索灵感库、查询模型定价、检测 AIGC。详见 docs/guide-mcp.md。

---

功能一览

	能力	说明
🤖	MCP Server	内置 MCP 协议支持，Claude Desktop / Cursor / Windsurf / VS Code 开箱即用
🔬	AIGC 检测引擎	C2PA / TC260 / SynthID / ONNX / FFT / SRM 噪声 / JPEG 量化 + 可见水印检测，离线运行，emoji 输出
🔌	多 Provider 统一入口	改一个 base_url 切换 Provider，命令不变
🧠	Provider 自动适配	OpenRouter 自动走专用图片/视频 API，零配置
🎨	Midjourney 完整管线	17 子命令覆盖 imagine → blend → describe → upscale → zoom → inpaint → video → remix，无需 Discord
💬	Agentic Chat	交互式 REPL 内嵌 generate_image / generate_video / midjourney_* / ideas 等工具
🔍	提示词灵感库	离线 BM25 搜索引擎（CJK 感知 + n-gram + RRF），万级提示词数据集
🔊	本地 TTS / ASR	sherpa-onnx 离线语音合成（kokoro 53 种音色，中英日韩法）和语音识别（SenseVoice 中文最佳），无需联网
🔄	视频任务持久化	OpenRouter 提交→轮询→下载全流程，超时后 --job-id 一键恢复
🧪	Dry-Run & Curl	--dry-run 输出等价 curl 命令，学习和调试 API 零门槛
⚡	Go 单二进制	go install 一键安装，无 runtime 依赖，跨平台

---

Provider 自动适配

同样的 image / video / audio / models 命令，背后走的 API 路径根据 Provider 自动切换：

| Provider | Image | Video | Audio | Models | |---|---|---|---|---|---| | OpenAI | POST /v1/images/generations（同步） | — | POST /v1/audio/speech + POST /v1/audio/transcriptions | GET /v1/models | | OpenRouter | POST /api/v1/images（专用图片 API） | POST /api/v1/videos 异步→轮询→下载 + --job-id 恢复 | POST /api/v1/audio/speech + POST /api/v1/audio/transcriptions（10+ TTS 模型聚合） | GET /api/v1/images/models / GET /api/v1/videos/models（免认证） | | APIMart | 异步 Task 提交→轮询→下载 | 异步 Task + VEO3 Remix（延长视频） | POST /v1/audio/speech + POST /v1/audio/transcriptions | 市场 API + 模型定价查询 | | 云雾 AI | — | POST /v1/video/create + GET /v1/video/query | ❌ 暂未发现 | — | | Ollama / 本地模型 | POST /v1/images/generations（experimental，无需 API Key） | ❌ | 可通过 LocalAI/openedai-speech 等第三方服务 | GET /v1/models | | 通用中转 | POST /v1/images/generations（同步） | — | POST /v1/audio/speech（透传） | GET /v1/models |

本地模型 / 服务无需 API Key，aigc-cli 会自动豁免 API Key 检查并跳过 Authorization 头。详见 docs/installation.md#本地生成。

检测逻辑：根据 base_url 自动识别，也可用 --mode sync / --mode async 手动指定。

---

命令

aigc-cli
├── image / img   图片生成（同步/异步/OpenRouter 专用 API / Grok Edit）    →  docs/guide-image.md
├── video / vid   视频生成（OpenRouter / 云雾 + VEO3 Remix）               →  docs/guide-video.md
├── audio / voice 音频：文字转语音（TTS）和语音转文字（STT）              →  docs/guide-audio.md
│   ├── tts / speak  文字→语音（云端 API 或本地 sherpa-onnx 离线合成）
│   ├── asr / stt    语音→文字（云端 API 或本地 sherpa-onnx 离线识别）
│   └── init         下载本地模型（kokoro / sense-voice 等 12 种）
├── ocr            离线文字识别（DBNet + CRNN，ONNX 本地推理）            →  docs/guide-ocr.md
│   ├── init        下载 OCR 模型
│   └── scan        识别图片中的文字
├── background / bg  AI 背景去除（基于 RMBG 2.0 语义分割，纯离线 ONNX 推理）  →  docs/guide-background.md
├── midjourney / mj                                                       →  docs/guide-midjourney.md
│   └── mj     别名，同上
├── chat       AI 对话 / 交互式 REPL / Agent Loop（工具调用）              →  docs/guide-chat.md
├── ideas / idea 提示词灵感搜索（关键词 / 随机，默认不加参数随机一条）    →  docs/guide-ideas.md
├── models / model                                                          →  docs/guide-model.md
│   └── --price    查看模型定价
├── task       查询异步任务状态（兼容 APIMart 异步任务）
├── balance    查询余额（兼容 APIMart 余额查询）
├── preview / pr 看图 / --detail 元数据 / --describe 写说明                    →  docs/guide-preview.md
├── detect     检测水印、元数据和 AIGC（多信号融合 + emoji）             →  docs/guide-detect.md
├── completion 生成 shell 补全脚本（bash/zsh/fish/powershell）
├── mcp        启动 MCP Server（AI 代理集成）                              →  docs/guide-mcp.md
│
│   # 全局标志
│   --dry-run      打印请求参数和等价 curl，不调用 API
│   --print-config 打印当前生效的配置（含来源标注）
│   -v/--verbose   显示详细输出：完整 JSON、Token 用量、耗时、费用
│   --json         以 JSON 格式传入请求（文件、字符串或 stdin）
│   --preview      生成完成后自动打开系统预览
│   --save-prompt  将提示词保存为 .md 文件
│   --http-proxy   指定 HTTP 代理

启用 Tab 补全

安装后，在 shell rc 文件中加入以下一行即可启用命令和参数补全：

# Bash
echo 'source <(aigc-cli completion bash)' >> ~/.bashrc

# Zsh
echo 'source <(aigc-cli completion zsh)' >> ~/.zshrc

# Fish
aigc-cli completion fish > ~/.config/fish/completions/aigc-cli.fish

重新加载 shell 后，输入 aigc-cli im+Tab 会自动补全为 aigc-cli image。

---

Midjourney 子命令一览

aigc-cli midjourney (或 mj)
├── imagine       文生图 / 图生图（默认入口）
├── blend         多图融合（2-4 张）
├── describe      图转文（反向提示词）
├── edits         图片编辑（重写整图）
├── upscale       放大单张（U1-U4）
├── variation     微变体（V1-V4）
├── high-variation 强变体
├── low-variation  弱变体
├── reroll        重新生成网格
├── zoom          拉远 / 外绘
├── pan           平移（左/右/上/下）
├── inpaint       局部重绘入口（→ modal）
├── modal         提交蒙版 + 提示词完成重绘
├── video         图生视频
├── remix-strong  强重塑（v8/v8.1）
├── remix-subtle  弱重塑（v8/v8.1）
└── query         查询任务状态

---

文档

文档	内容
安装与配置	安装、API Key、配置文件、代理
图片生成	全部参数、同步/异步模式、图生图、Inpainting
视频生成	全部参数、首尾帧、参考视频（APIMart）
Midjourney 生成	17 个子命令完整说明：imagine、blend、upscale 等
AI 对话	交互式多轮 REPL、流式输出、verbose 统计
AIGC 检测	多信号融合、ONNX 模型、FFT 频谱、emoji 输出
提示词灵感	离线 BM25 搜索引擎，万级提示词数据集
其他命令	models、task、balance、dry-run、API 参考
API 参考来源	各 Provider 接口规范来源、检测机制、策略路由
常见问题	安装、使用、MCP、费用等常见问题解答
MCP 集成	AI 代理（Claude/Cursor）集成指南

---

优先级规则

CLI 参数 > JSON 输入 > YAML 配置 > 代码默认值

代理优先级： --http-proxy 参数 > HTTP_PROXY / HTTPS_PROXY 标准环境变量

---

贡献

欢迎贡献！详见 CONTRIBUTING.md。

---

法律声明

本软件首先是一个 AIGC 检测与研究工具。不内置任何厂商的去水印能力。--remove-watermark 仅对用户通过 --learn-watermark 自行学习的水印生效。用户应自行确保使用行为符合适用法律法规。

用户应自行承担使用本软件的一切法律责任。软件作者不对用户的任何使用行为承担法律责任。

License

MIT

欢迎关注微信公众号"没有那多"，分享更多好用、好玩的工具