核心用法
AIMLAPI Media Generation 是一套用于调用 AIMLAPI 进行 AI 图像和视频生成的 Python 脚本工具。该技能提供两个主要入口：gen_image.py 用于图像生成，gen_video.py 用于视频生成。
图像生成采用同步调用模式，直接通过 /v1/images/generations 端点获取结果，支持指定模型（如 aimlapi/openai/gpt-image-1）、尺寸、生成数量等参数，并内置最多 4 次重试机制应对瞬时网络故障。
视频生成采用异步工作流：首先 POST 创建生成任务，随后通过 GET 轮询任务状态（in_progress → completed），最后下载成品视频。脚本支持可配置的轮询间隔（默认 10 秒）和最大等待时间（默认 1000 秒），避免无限阻塞。
两项工具均强制要求 User-Agent 头部，支持 API Key 文件回退机制，并提供详细日志输出便于调试。
显著优点
1. 健壮性设计：内置指数退避重试和显式错误处理，降低 API 瞬态故障导致任务失败的风险
2. 异步原生：视频生成完整实现 AIMLAPI 的异步轮询协议，而非简单阻塞等待
3. 可观测性：详细日志记录请求-响应周期、轮询状态变化，便于审计和故障排查
4. 配置灵活：支持命令行参数覆盖环境变量，适应 CI/CD 和本地开发不同场景
潜在缺点与局限性
- 供应商锁定：深度绑定 AIMLAPI 的端点结构和异步协议，迁移至其他平台（如 Replicate、Runway）需重写轮询逻辑
- 成本不可控：视频生成按秒计费且轮询次数增加 API 调用量，长时任务可能产生意外费用
- 无内置限流：脚本未实现请求速率限制，高并发场景可能触发平台封禁
- Python 依赖：需 Python 3 环境，对于纯 Node.js 或容器化工作流需额外适配层
适合人群
- 需要将 AI 媒体生成集成到自动化流水线（GitHub Actions、Argo Workflows）的 DevOps 工程师
- 构建批量内容生成工具的产品团队，追求"提交即走"的可靠执行
- 已通过 AIMLAPI 采购额度、需要程序化消耗 API 积分的组织
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| API Key 泄露 | 环境变量或文件落盘可能被容器日志捕获 | 使用临时文件、secret 管理工具，避免 `--api-key` 明文传参 |
| 轮询费用累积 | 频繁轮询增加 API 调用成本 | 合理设置 `--poll-interval`（建议 ≥10 秒）和 `--max-wait` |
| 生成内容合规 | AI 生成媒体可能包含版权或敏感元素 | 启用 AIMLAPI 的内容过滤，人工审核关键产出 |
| 长时间阻塞 | 视频生成可能耗时数分钟至数小时 | 在异步架构中考虑将任务拆分为"提交"和"回调拉取"两个阶段 |
技术细节补充
- 图像生成支持
1024x1024、1792x1024、1024x1792等标准尺寸 - 视频模型
google/veo-3.1-t2v-fast为当前推荐的快速变体，平衡质量与成本 --user-agent参数对于某些企业防火墙后的环境是强制性的，否则可能返回 403