https://github.com/martianzhang/aigc-cli

AIGC CLI - 统一 AI 图片、视频、Midjourney 生成与检测命令行工具。支持 OpenAI、OpenRouter 及任意 OpenAI 兼容中转。内置 MCP Server、AIGC 检测引擎。
https://github.com/martianzhang/aigc-cli

ai aigc aigc-cli aigc-detection chatbot cli go image-generation mcp midjourney openai openrouter video-generation

Last synced: about 8 hours ago
JSON representation

AIGC CLI - 统一 AI 图片、视频、Midjourney 生成与检测命令行工具。支持 OpenAI、OpenRouter 及任意 OpenAI 兼容中转。内置 MCP Server、AIGC 检测引擎。

Host: GitHub
URL: https://github.com/martianzhang/aigc-cli
Owner: martianzhang
License: mit
Created: 2026-06-15T03:28:06.000Z (24 days ago)
Default Branch: main
Last Pushed: 2026-07-07T08:26:23.000Z (2 days ago)
Last Synced: 2026-07-07T09:18:17.925Z (2 days ago)
Topics: ai, aigc, aigc-cli, aigc-detection, chatbot, cli, go, image-generation, mcp, midjourney, openai, openrouter, video-generation
Language: Go
Homepage:
Size: 42.3 MB
Stars: 3
Watchers: 0
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Agents: AGENTS.md

Awesome Lists containing this project

README

          ![aigc-cli](logo.svg)

[![CI](https://github.com/martianzhang/apimart-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/martianzhang/apimart-cli/actions/workflows/ci.yml)

[![Go Version](https://img.shields.io/github/go-mod/go-version/martianzhang/apimart-cli)](https://go.dev/)

[![License](https://img.shields.io/github/license/martianzhang/apimart-cli)](LICENSE)

[![Release](https://img.shields.io/github/v/release/martianzhang/apimart-cli)](https://github.com/martianzhang/apimart-cli/releases)

**一个 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 页面](https://github.com/martianzhang/aigc-cli/releases) 下载对应平台的二进制文件。

### 使用 OpenAI

```bash

export OPENAI_API_KEY="sk-xxx"

aigc-cli image --prompt "一只猫在星空下"

aigc-cli chat --message "你是谁？"

```

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

```bash

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 兼容中转

```bash

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 配置中添加：

```json

{

  "mcpServers": {

    "aigc-cli": {

      "command": "aigc-cli",

      "args": ["mcp"]

    }

  }

}

```

AI 代理可以在对话中直接生成图片、创建视频、查询模型、检测 AIGC。详见 [docs/mcp.md](docs/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），万级提示词数据集 |

| 🔄 | **视频任务持久化** | OpenRouter 提交→轮询→下载全流程，超时后 `--job-id` 一键恢复 |

| 🧪 | **Dry-Run & Curl** | `--dry-run` 输出等价 curl 命令，学习和调试 API 零门槛 |

| ⚡ | **Go 单二进制** | `go install` 一键安装，无 runtime 依赖，跨平台 |

---

## Provider 自动适配

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

| Provider | Image | Video | Models |

|---|---|---|---|

| **OpenAI** | `POST /v1/images/generations`（同步） | — | `GET /v1/models` |

| **OpenRouter** | `POST /v1/images`（专用图片 API）或 `POST /v1/responses`（Responses API） | `POST /v1/videos` 异步→轮询→下载 + `--job-id` 恢复 | `GET /v1/images/models` / `GET /v1/videos/models`（免认证） |

| **APIMart** | 异步 Task 提交→轮询→下载 | 异步 Task + VEO3 Remix（延长视频） | 市场 API + 模型定价查询 |

| **云雾 AI** | — | `POST /v1/video/create` + `GET /v1/video/query` | — |

| **通用中转** | `POST /v1/images/generations`（同步） | — | `GET /v1/models` |

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

---

## 命令

```

aigc-cli

├── image      图片生成（同步/异步/OpenRouter 专用 API / Grok Edit）        →  docs/guide-image.md

├── video      视频生成（OpenRouter / 云雾 + VEO3 Remix）                    →  docs/guide-video.md

├── midjourney Midjourney 完整流水线（17 子命令）                          →  docs/guide-midjourney.md

│   └── mj     别名，同上

├── chat       AI 对话 / 交互式 REPL / Agent Loop（工具调用）              →  docs/guide-chat.md

├── ideas      提示词灵感搜索（关键词 / 随机 / 图文，支持 BM25 + n-gram）   →  docs/guide-ideas.md

├── models     模型列表（OpenRouter 发现 / OpenAI 兼容）

│   └── --price    查看模型定价

├── task       查询异步任务状态（兼容 APIMart 异步任务）

├── balance    查询余额（兼容 APIMart 余额查询）

├── preview    用系统默认程序预览生成的图片/视频

├── detect     检测水印、元数据和 AIGC（多信号融合 + emoji）             →  docs/guide-detect.md

├── mcp        启动 MCP Server（AI 代理集成）                              →  docs/mcp.md

│

│   # 全局标志

│   --dry-run      打印请求参数和等价 curl，不调用 API

│   --print-config 打印当前生效的配置（含来源标注）

│   -v/--verbose   显示详细输出：完整 JSON、Token 用量、耗时、费用

│   --json         以 JSON 格式传入请求（文件、字符串或 stdin）

│   --preview      生成完成后自动打开系统预览

│   --save-prompt  将提示词保存为 .md 文件

│   --http-proxy   指定 HTTP 代理

```

### 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         查询任务状态

```

---

## 文档

| 文档 | 内容 |

|---|---|

| [安装与配置](docs/installation.md) | 安装、API Key、配置文件、代理 |

| [图片生成](docs/guide-image.md) | 全部参数、同步/异步模式、图生图、Inpainting |

| [视频生成](docs/guide-video.md) | 全部参数、首尾帧、参考视频（APIMart） |

| [Midjourney 生成](docs/guide-midjourney.md) | 17 个子命令完整说明：imagine、blend、upscale 等 |

| [AI 对话](docs/guide-chat.md) | 交互式多轮 REPL、流式输出、verbose 统计 |

| [AIGC 检测](docs/guide-detect.md) | 多信号融合、ONNX 模型、FFT 频谱、emoji 输出 |

| [提示词灵感](docs/guide-ideas.md) | 从 Image2Studio 搜索 AI 图片提示词灵感 |

| [其他命令](docs/guide-commands.md) | models、task、balance、dry-run、API 参考 |

| [API 参考来源](docs/api-reference.md) | 各 Provider 接口规范来源、检测机制、策略路由 |

| [常见问题](docs/faq.md) | 安装、使用、MCP、费用等常见问题解答 |

| [MCP 集成](docs/mcp.md) | AI 代理（Claude/Cursor）集成指南 |

---

## 优先级规则

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

代理优先级：

**`--http-proxy` 参数 > `OPENAI_HTTP_PROXY` / `APIMART_HTTP_PROXY` 环境变量 > `HTTP_PROXY` 标准环境变量**

---

## 贡献

欢迎贡献！详见 [CONTRIBUTING.md](CONTRIBUTING.md)。

---

## License

[MIT](LICENSE)





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

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/martianzhang/aigc-cli

Awesome Lists containing this project

README