Python 工具
图像生成、文档处理与视觉 API 调用
agnes-draw.py
Agnes AI 中国站直连的图像生成工具。支持多种画面比例,内置自检与质量门禁。
用法
# 基本用法
python python/agnes-draw.py "一只白鹭在雾中飞翔" --ratio 3:4 --out output.png
# 自检:检查密钥 / 模型 / 网络 / 输出目录
python python/agnes-draw.py --diagnose
参数
| 参数 | 说明 | 默认 |
|---|---|---|
prompt | 图像描述,必填 | — |
--ratio | 比例:1:1 / 3:4 / 4:3 / 16:9 / 9:16 / 2:3 | 1:1 |
--out | 输出文件路径 | 自动生成 |
--diagnose | 运行自检后退出 | false |
密钥
按优先级读取:环境变量 AGNES_API_KEY → provider-catalog.json 中 agnes provider 的 api_key。
pdf-pipeline.py
PDF 批量处理管线,支持合并、拆分、水印、加密。
# 合并
python python/pdf-pipeline.py merge --input a.pdf b.pdf --output merged.pdf
# 添加水印
python python/pdf-pipeline.py watermark --input doc.pdf --watermark w.pdf
cover-text.py
封面文字合成工具。用 PIL 精确渲染中文标题,规避 AI 生图把文字画错的问题。
python python/cover-text.py --image background.png --title "项目名称" --output cover.png
# 主副标题
python python/cover-text.py --image bg.png --title "主标题" --subtitle "副标题" --output r.png
其他
| 文件 | 用途 |
|---|---|
apply_pattern.py | 图案应用工具 |
generate_diagrams.py | 示意图批量生成 |
call_zhipu.py | 智谱视觉 API 调用,读 ZHIPU_API_KEY / ZHIPU_MODEL_ID |
call_zhipu_nossl.py | 跳过 SSL 验证的变体,含本机路径,按需自改 |
更新于 2026-09 · Python 3.8+