Media.io Generate 是一个面向 Media.io CLI 的生成类技能,用于在当前已安装的 mediaio 命令行环境中提交图片和视频生成任务,包括文生图、图生图、文生视频等。
用途与定位 该技能本身不内置模型,而是作为操作层调用当前 mediaio CLI。CLI 帮助、模型/工作流/特效的发现输出以及 model get、workflow get 的结果被视为唯一事实来源,任务类型取自静态目录,参数取自 model get。
使用方式
- 启动检查:先运行 command -v mediaio 与 mediaio version。命令缺失时须告知用户需要安装共享的 Media.io CLI,而不应静默安装另一个运行时。若版本输出包含“Update: ... (update available)”,视为必须交接点,需引用该行并询问是否运行 mediaio upgrade --output json,用户答复前不得继续发现、生成、上传或等待。升级结果只依据标准 JSON 信封判断;data.cli.scheduled=true(仅 Windows)时需提示用户重启会话。
- 网络审批:在当前任务中启动首个联网 mediaio 进程前,须通过宿主最小范围的仅网络审批机制提交调用;若不可用,才在说明更宽范围后使用通用沙箱外审批。涉及写入本地状态(如登录凭据)时还需申请文件写入权限。宿主无法提供所需审批时应报告限制并停止。
- 鉴权:运行 mediaio account status;仅在认证确实缺失、过期或被服务端拒绝时运行 mediaio auth login,并等待浏览器流程完成。DNS、TLS、超时、连接与沙箱拒绝属于网络故障而非认证故障。登录成功后应沿用用户原始提示与参数继续原任务,并重新查询账户状态以获取最新积分与等级。
- 任务提交:先提交生成任务,读取返回的 task_id=<id> 行,再调用 mediaio generate wait <task_id>;当前 generate create 不接受 --wait。不得虚构任务类型或参数。
积分处理 generate create 会消耗用户积分,每次提交需加 --yes。默认采用静默模式,只交付结果、不提费用;当用户在本轮或此前提到积分、成本、价格、余额、配额,或表达节省意愿时升级为报告模式,随结果一并说明费用;当用户要求先看价格、对先前扣费有异议或余额相对成本偏低时,升级为先行批准模式:先运行 generate estimate 取得估算与余额,向用户说明任务类型、预估费用、剩余余额及实际扣费以服务端为准,然后结束本轮等待明确同意,不得在同轮链式提交。任何重试都视为新扣费,需重新询问。禁止使用 --skip-estimate,禁止自行开启 auto-confirm 扩大消费权限。
结果与链接 结果优先通过 mediaio generate download 获取,避免手工复现签名链接;签名结果 URL 不得重打、改写或增删查询参数,出现存储凭据错误时应重新下载获取新签名。CLI 能直接回答的问题优先用 CLI(如 generate list、upload list),需要更完整历史、预览或文件管理时,仅通过 CLI 打印的链接跳转网页应用;积分不足时使用 mediaio link get credits,其他管理场景使用 mediaio link get home,不得自行拼写或编辑 media.io URL,也不得描述支付步骤。输出保持简洁,不暴露访问令牌、凭据或无关任务提示词。
适用场景 适合已安装 mediaio CLI 并完成鉴权的用户,通过自然语言发起图片或视频生成、查看近期任务、下载结果;也适用于对成本敏感、需要先估算再批准的用户。
限制 模型与参数必须来自 CLI 与静态目录,不能凭记忆构造;未提供 CLI 或宿主审批能力不足时无法执行;更新提示受 24 小时节流,其缺失不代表已确认最新;具体可用模型、计费规则与平台支持以 CLI 实际输出为准,资料未提供固定清单。