MuAPI Media 是一套面向图像和视频生成的技能说明，适用于需要调用 MuAPI 统一异步媒体 API 的代理工作流。它的核心思路是把模型发现、请求构造、提交、轮询和下载拆成可审查的步骤，避免为每个模型单独做集成，也避免凭猜测填写字段。
用途 当用户明确要求使用 MuAPI 生成图像或视频时使用；当现有媒体流程需要托管式异步 API 并能够发送授权 HTTPS 请求时使用；当需要在当前媒体模型之间比较或切换、又不改变提交与轮询流程时使用。该技能不用于文本聊天，也不用于尚未获取并核对当前 schema 的服务商。
主要能力 技能描述的 API 契约包括：GET https://api.muapi.ai/api/v1/models 列出当前模型；GET https://api.muapi.ai/api/v1/models/{model} 读取单个模型 schema；POST https://api.muapi.ai/{catalog endpoint} 提交生成；GET https://api.muapi.ai/api/v1/predictions/{request_id}/result 轮询预测结果。生成与预测请求使用 x-api-key: $MUAPI_API_KEY 和 Content-Type: application/json。目录返回模型名称、类别、端点等元数据，端点已包含 /api/v1/ 前缀，拼接时不再重复添加版本前缀。模型输入输出字段各不相同，准备请求前必须读取所选模型的详细 schema，核对必填项、类型、枚举值、大小限制和输出 schema。
使用方式
- 发现并验证模型：用临时目录保存响应文件，先只读拉取模型目录，筛选图像、视频、音频、3D 等类别，选定模型后获取其 input_schema。若模型需要图像或视频输入，使用文档规定的字段和授权的 HTTPS 输入 URL，不自行发明上传契约。
- 准备一次经审查的请求：仅在环境中设置 MUAPI_API_KEY，缺失则停止；只添加 schema 确认的字段，示例中使用 prompt 字段，许多模型还要求时长、分辨率、宽高比或输入 URL。提交前与用户确认模型、参数、目标位置和预估费用，密钥不得写入 request.json。
- 只提交一次：解析目录端点后执行一次 POST；生成 POST 超时后不自动重试，因为原任务可能已被接受；保留 request_id 用于诊断，不打印请求头或密钥。
- 有限轮询：对原始 request_id 轮询，接受文档规定的终态，设置尝试次数上限（示例为 120 次）、每次间隔 2 秒；失败状态输出错误并退出；轮询中断时不新建付费任务，先再次查询已知 request_id。
- 无密钥下载：按模型输出 schema 提取 HTTPS 输出 URL，用不带 MuAPI 请求头的新请求下载，校验文件非空并用 file 检查类型；拒绝非 HTTPS 输出 URL，谨慎处理重定向，不执行下载文件。
适用场景 需要托管式异步媒体生成、需要在多个当前模型间切换而不改动提交轮询结构、需要对生成请求做显式授权与费用确认的工作流。也适合需要把密钥隔离在环境变量、并把输出下载与认证请求分离的代理流程。
限制 该技能仅为指令说明，不安装 SDK 或后台 worker；模型、schema、价格、输出保留时间和支持字段可能变化，以实时目录为准；生成是异步的，可能耗时数分钟或在提交后失败；输出 URL 可能过期，不能当作永久资产链接；HTTP 成功不保证媒体文件有效可用；技能不替代对媒体质量、权利、安全和服务商政策合规的人工审查。
安全注意事项 提示词和参考媒体应视为发送给第三方的数据，需取得同意并避免不必要的个人或机密信息；不得记录、回显、提交 MUAPI_API_KEY 到 JSON 载荷或进程参数中，应通过受保护的 stdin 或受保护配置文件传递认证头；不得把 API 密钥转发给输出主机、重定向、浏览器 URL 或用户控制域名；未经明确授权，不将本流程用于批量生成、文件托管或无关网络传输；生成媒体应保存在受控输出目录并在打开或分享前检查。