用途：在任意项目中集成 imini 的 AIGC 图像与视频生成 API，完成模型选择、成本估算与完整异步任务代码生成。
主要能力：统一端点 https://openapi.imini.ai/imini/router；统一鉴权，一个 Bearer API key 适用于所有模型；统一异步模式，每次生成返回 task_id，轮询任务查询端点直到状态为 succeeded 或 failed，状态值只有 queued / processing / succeeded / failed，不存在 pending / completed / running；统一错误结构 { error: { code, message, status, request_id } }。支持文生图、参考图编辑、文生视频、首尾帧、参考视频及图像+视频+音频多模态输入。
使用方式：先向用户索取 imini API key（https://imini.ai/api-keys 或 https://imini.ai/zh/api-keys），不得硬编码，使用环境变量 IMINI_API_KEY。确认图像或视频、输入模态、画质档位（图像 1K/2K/4K 或 512，视频 480P/720P/1080P）、时长与目标语言。用脚本获取最新目录：python3 scripts/fetch_imini_catalog.py，可加 --type image、--type video、--model、--json。按 references/model_selection.md 推荐 1–2 个模型并估算积分成本，确认后从目录记录的 Spec 地址获取 OpenAPI YAML（如 https://docs.imini.ai/en/openapi/images/nano-banana-pro.yaml）。生成代码须含提交函数、带指数退避与硬超时的轮询循环、结果提取（图像取 images[]，视频取 videos[]，逐项遍历，勿硬编码 [0]）与错误处理。支持 Python（同步/异步）、Node.js、TypeScript、cURL。
生产建议：轮询起始间隔图像约 2s、视频约 5s，指数退避加 ±20% 抖动；HTTP 429 时退避下限提至 ≥5s；默认超时图像最长 15 分钟、视频最长 30 分钟；用信号量或工作池控制并发；记录 task_id 与预估积分成本。
限制：具体模型清单、价格与错误码以官方文档为准；资料未提供各模型详细参数与完整定价表。