菜单
Use "aigc-cli image" to generate images via OpenAI-compatible APIs (APIMart, OpenAI, OpenRouter). Supports text-to-image, image-to-image, inpainting, Grok Imagine Edit (--edit), local file upload, dry-run, proxy, sync/async mode detect. Automatically polls task and downloads images.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
| name | aigc-cli-text2image |
| description | Use "aigc-cli image" to generate images via OpenAI-compatible APIs (APIMart, OpenAI, OpenRouter). Supports text-to-image, image-to-image, inpainting, Grok Imagine Edit (--edit), local file upload, dry-run, proxy, sync/async mode detect. Automatically polls task and downloads images. |
通过 aigc-cli image 调用 OpenAI 兼容 API 生成图片。支持 APIMart（异步任务）、OpenAI / OpenRouter（同步），自动检测 API 地址并选择对应模式。也支持 Grok Imagine 1.5 Edit 图片编辑（--edit 模式）。提交任务后自动轮询完成并下载图片到当前目录。
aigc-cli（go install 或 make build）~/.config/aigc-cli/config.yaml 或 OPENAI_API_KEY 环境变量）
defaults.image 下配置defaults.midjourney 下配置# 直接传提示词
aigc-cli image --prompt "你的提示词"
# --prompt 不传时默认读 stdin
echo "你的提示词" | aigc-cli image
aigc-cli image < prompt.txt
提交后自动轮询，任务完成即下载图片到当前目录。
自动检测 API 地址，APIMart 域名走异步，其他（openai.com、openrouter.ai 等）走同步：
# 自动同步模式
aigc-cli image --base-url "https://openrouter.ai/api/v1" \
--prompt "a cat" --model "openai/dall-e-3"
# 强制指定模式
aigc-cli image --mode sync --prompt "..."
aigc-cli image --mode async --prompt "..."
同步模式支持 --style vivid|natural 和 --response-format url|b64_json。
aigc-cli image \
--prompt "提示词" \
--model "gpt-image-2-official" \
--size "16:9" \
--resolution "2k" \
--quality "high" \
--output-format "jpeg" \
--n 1 \
--output ./output \
--style vivid \
--background transparent \
--output-compression 85
提示词较长时，写入文件后传给 --prompt（自动识别文件）：
cat > prompt.txt << 'EOF'
详细的图片描述...
EOF
aigc-cli image --prompt prompt.txt
或通过 stdin：
echo "详细描述" | aigc-cli image
aigc-cli image --json '{
"model": "gpt-image-2-official",
"prompt": "your prompt",
"size": "16:9",
"resolution": "2k",
"n": 2
}'
aigc-cli image \
--prompt "融合两张参考图" \
--image-url "https://example.com/img1.png" \
--image-url "https://example.com/img2.png"
# Inpainting：替换背景
aigc-cli image \
--prompt "把背景换成沙漠日落" \
--image-url "https://example.com/photo.png" \
--mask-url "https://example.com/mask.png"
⚠️ 仅 Grok Imagine 1.5 Edit 模型支持，不是所有模型都有此功能。
# 背景替换
aigc-cli image --edit \
--prompt "把背景换成星空，保留主体" \
--image-url ./photo.jpg
# 风格迁移
aigc-cli image --edit \
--prompt "换成赛博朋克风格" \
--image-url ./img.png \
--n 2
--edit 模式下自动默认模型 grok-imagine-1.5-edit-apimart，--image-url 必填。
--size、--quality、--output-format 在 edit 模式下不会使用（由模型内部处理）。
--edit 为 APIMart 专属功能（仅异步模式），如果 API 地址不是 APIMart 域名会报错。
--image-url 和 --mask-url 支持本地文件路径，自动上传到 APIMart 后获取 URL：
aigc-cli image --prompt "吉卜力风格" --image-url ./my-photo.jpg
aigc-cli image --prompt "换背景" --image-url ./photo.png --mask-url ./mask.png
仅 APIMart 异步模式支持本地上传，同步模式（OpenAI/OpenRouter）需使用公开 URL。
| 参数 | 功能 | 适用 |
|---|---|---|
--background auto|opaque|transparent | 图片背景模式 | APIMart |
--moderation auto|low | 内容审核强度 | APIMart |
--output-compression 0-100 | jpeg/webp 压缩级别 | APIMart |
--mode sync|async|auto | 强制生成模式 | 跨平台 |
--save-prompt | 保存 prompt 到 .md 文件 | 通用 |
查看即将提交的 curl 命令，不实际调用 API：
aigc-cli image --prompt "test" --size "16:9" --dry-run
参考定价页 https://apimart.ai/pricing
gpt-image-2-official 最低 $0.00144/张：
aigc-cli image \
--prompt "提示词" \
--size "3:1" \
--resolution "1k" \
--quality "low"
或设入 config.yaml 作为全局默认值。
如果用户环境需要代理才能访问外网：
# --http-proxy 参数（支持 http/https/socks5）
aigc-cli image --prompt "..." --http-proxy "http://127.0.0.1:7890"
# 环境变量（自动识别）
export HTTP_PROXY="http://127.0.0.1:7890"
# 或 config.yaml
# http_proxy: "http://127.0.0.1:7890"
支持 http://、https://、socks5:// 协议。
# 查看即将提交的完整请求 JSON
aigc-cli image --prompt "test" -v
# Dry-run：打印 curl 命令，不实际调用
aigc-cli image --prompt "test" --dry-run
# 保存 prompt 到 image_{task_id}.md（后续可追溯）
aigc-cli image --prompt "A red fox" --save-prompt
# 强制异步模式（走任务队列，支持本地文件上传）
aigc-cli image --prompt "cat" --mode async
# 强制同步模式（兼容 OpenAI/OpenRouter）
aigc-cli image --prompt "cat" --mode sync
quality: "high" + resolution: "2k"/"4k" 耗时较长（可能 120 秒以上）--output 指定）--edit（Grok Edit）仅 APIMart 异步模式可用，需使用 APIMart 平台 API--dry-run 先确认请求参数正确Use "aigc-cli midjourney" (alias "mj") to generate and edit images via Midjourney on APIMart. Supports imagine, blend, describe, edits, upscale, variation, reroll, zoom, pan, inpaint, modal, video, remix. All async task-based. Automatically polls task and downloads results.
Use "aigc-cli video" to generate videos via the APIMart API (doubao-seedance-2.0, VEO3). Supports text-to-video, image-to-video, first/last frame, reference video/audio, audio-enabled video, VEO3 Remix (--remix), seed, web_search tool, and return-last-frame for continuation. Automatically polls task and downloads videos.
Use "aigc-cli image" with OpenRouter to generate images via the Responses API. Supports text-to-image with aspect ratio control. Automatically detects OpenRouter from --api-base / OPENAI_BASE_URL and uses POST /v1/responses with image output modalities.
Use "aigc-cli video" with OpenRouter to generate videos via the dedicated video API. Supports text-to-video, image-to-video (first frame), aspect ratio, resolution, and duration control. Uses async submit → poll → download pattern.
基于 SOC 职业分类
