aigc-cli

CI Go Version License Release

一个 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

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