用途：通过捆绑的 scripts/muapi_media.py CLI 发现当前 MuAPI 图像模型，并提交一次经明确确认的图像生成请求。适用于查找当前 MuAPI 图像模型、需要精确模型端点而非记忆别名、用户已明确批准可能计费的生成请求，以及需要对异步预测进行有限状态轮询的场景。仅覆盖文生图与图生图，不适用于视频、音频、3D、聊天或模型训练请求。
主要能力：CLI 使用实时目录中的 name、category 和已带版本的 endpoint 字段，并轮询标准预测结果端点；不假设目录包含内联请求 schema，模型专属字段仅依据当前模型契约添加。命令输出结构化 JSON 到 stdout，成功生成包含所选模型、请求 ID、终态状态、输出 URL，以及请求时的本地产物路径。
使用方式：先设置环境变量 export MUAPI_API_KEY="your-api-key"，切勿作为 CLI 参数传递或提交。MUAPI_BASE_URL 可选，默认 https://api.muapi.ai。发现模型：python3 scripts/muapi_media.py models --category image --query flux。准备参数文件（prompt 必填，仅保留所选模型当前契约支持的字段）。生成：python3 scripts/muapi_media.py generate flux-dev --params-file request.json --confirm-paid。可用 --output ./muapi-output.png 下载首个完成产物。
限制与安全：--confirm-paid 为强制项；CLI 只发送一次生成 POST，绝不重试不明确的 POST，仅以 GET 轮询且预算有限。API 密钥须保留在服务端，远离日志、提示、截图和提交文件。不得自动重试生成 POST，再次付费请求需重新获得用户确认。轮询仅用 GET 并在 --max-polls 停止。保留目录端点路径，不要对已含 /api/v1/ 的端点重复添加。仅下载 HTTPS 输出 URL，且不向输出主机转发 API 密钥。敏感、受监管或高影响内容需人工审核。官方参考包括 MuAPI 模型目录、API 参考、图像模型和访问密钥。