用途：通过随附的 scripts/atlas_media.py CLI 发现当前 Atlas Cloud 图像或视频模型、查看模型实时请求 schema，并执行一次异步图像或视频生成。适用于查找可用模型、获取当前模型 ID/输入字段/端点/价格、提交一次经明确确认的生成请求，以及对异步任务做有上限的状态轮询。
配置：在环境变量中设置 API 密钥，不要作为 CLI 参数传入或提交到仓库：export ATLASCLOUD_API_KEY="your-api-key"。ATLASCLOUD_BASE_URL 可指向兼容部署，默认 https://api.atlascloud.ai。
用法：1) 发现模型：python3 scripts/atlas_media.py models --type Image --query flux，或 --type Video --query seedance；模型可用性与价格属实时数据，选模型前应立即运行发现命令。2) 查看 schema：python3 scripts/atlas_media.py describe black-forest-labs/flux-schnell，会解析当前 schema URL 并报告必填字段、属性定义、提交端点、结果端点与目录价格，应据此构建 payload。3) 在文件中准备参数，例如 {"prompt": "A clean product photograph on a neutral background", "size": "1024*1024", "num_images": 1}，不要包含 model，CLI 会在校验后插入所选模型 ID。4) 确认成本并生成一次：python3 scripts/atlas_media.py generate black-forest-labs/flux-schnell --params-file request.json --confirm-paid；--confirm-paid 为必填，CLI 只发送一次生成 POST 且不重试，仅轮询 schema 定义的 GET 结果端点，间隔固定且有最大轮询次数。也可用 stdin：printf '%s' '{"prompt":"A geometric app icon"}' | python3 scripts/atlas_media.py generate black-forest-labs/flux-schnell --params-file - --confirm-paid。
安全规则：密钥保持在服务端，远离日志、提示词、截图、浏览器代码、移动应用和已提交文件；绝不自动重试生成 POST，提交失败应报告错误并要求新的明确确认；仅用 GET 轮询并在 --max-polls 停止；更换模型时重新校验实时 schema；需要持久存储时在返回媒体 URL 过期前下载；敏感、受监管或高影响内容需人工审核。
输出：命令向 stdout 写结构化 JSON，成功生成输出包含 prediction ID、最终状态、生成 URL、模型 ID 及从实时 schema 解析的端点。