Media / Video Jobs

视频生成与异步任务完整指南

视频请求通常会产生付费异步任务。先确认模型、创建路径、查询路径、字段映射和实时价格,再提交一次;未知响应、超时和下载失败都不能自动创建第二个任务。

Evidence Gate

模型存在、端点标签和真实成功是三件事

等级含义本页用法
E1异步任务概念或静态路由已确认可以说明通用流程,不能为模型选择固定路径
E2公开模型名或 openai-video 标签存在只用于建立候选清单
E3创建或查询请求已进入实际链路可定位路由与字段问题,仍不等于作品生成成功
E4当前生产版本完成一次低额度任务、轮询和结果验证才可以固定记录路径、状态值和结果字段
本页边界截至 2026-07-18,Sora、Seedance、Omni 与 Grok 可从公开元数据建立候选清单;创建路径、请求字段、状态字段、终态值和结果字段均未完成本批 E4 复验。本次没有发送 API 请求。

OpenAI-Compatible Video

端点标签不能替代模型详情

openai-video 表示模型被归入视频兼容类别,但不足以确定创建请求使用哪条路径、JSON 还是 multipart、任务 ID 位于哪个字段,也不足以确认查询路径。

候选路径族可以写入文档的事实提交前动作
/v1/videos平台历史文档中存在该任务路径族必须在当前模型详情中确认创建、查询和字段
/v1/video/generations平台展示层可把视频标签映射到该候选路径展示映射不是 E4,仍须复制当前模型详情
其他或无路径当前模型映射未知停止,不在两条候选路径之间自动试撞
认证头候选Authorization: Bearer YOUR_API_KEY
API 根地址https://api.muxllm.com

Generic Text to Video

通用文生视频:先填写映射表,再执行

  1. 从模型广场复制模型名、全部端点标签和实时价格。
  2. 从该模型的当前说明复制创建 URL、请求格式、必填字段、查询 URL 规则和任务 ID 字段。
  3. 使用短 Prompt,省略时长、比例、清晰度、种子、参考图等所有未确认可选字段。
  4. 设置客户端生成 POST 自动重试次数为 0,只允许一次人工确认后的提交。
  5. 保存 HTTP 状态、脱敏响应、请求时间和可能的任务 ID;无法唯一识别任务时停止。
只在映射完成后填写的 JSON 模板
{
  "create_url": "COPY_CONFIRMED_CREATE_URL",
  "status_url_pattern": "COPY_CONFIRMED_STATUS_URL_PATTERN",
  "model": "MODEL_NAME_FROM_MARKETPLACE",
  "request_format": "COPY_JSON_OR_MULTIPART",
  "task_id_field": "COPY_CONFIRMED_TASK_ID_FIELD",
  "prompt": "雨后的城市街道,固定镜头,主体缓慢向前移动",
  "max_create_attempts": 1
}
不要直接提交此 JSON它是执行前检查表,不是平台请求体。任何 COPY_ 占位符未被当前模型说明替换时,必须停止。

MuxLLM / Sora

Sora 视频候选模型

当前公开元数据可在模型广场中检索 Sora 系列,例如 sora-2sora-2-pro 等名称。模型存在属于 E2;名称中的版本或 pro 不自动证明分辨率、时长、素材输入、价格或创建路径。

模型选择复制当前可见的完整模型 ID,并确认所属分组允许当前 Token 使用。
请求路径只使用该模型详情明确展示的创建和查询路径;没有查询规则就不要创建任务。
输入参数先做纯文本最小请求;时长、比例、清晰度和参考素材必须逐项有证据后添加。
验收完成任务 ID 保存、终态识别、结果下载和真实视频解码后才达到 E4。

MuxLLM / Seedance

Seedance 文生视频与图生视频要分开确认

当前公开元数据中可见 Seedance 系列名称。即使模型名包含 t2vi2vfast 或版本号,也只能作为候选线索;参考图片字段、素材数量、时长、比例和查询协议仍需当前模型详情确认。

任务必须确认缺失时
文生视频模型 ID、创建路径、Prompt 字段、价格、查询规则停止,不使用其他 Seedance 模型的字段代替
图生视频以上全部,加图片字段、URL/Base64/上传方式、格式和大小限制停止,不把图片塞进未知字段
快速或高规格版本独立价格、输出规格与限制按独立模型处理,不继承名称相近模型的参数

Gemini / Omni Video

本页列出的 Omni 目录项目前只有元数据证据

2026-07-18 的公开元数据快照包含本页下方列出的 Omni 名称,但没有本批 E4 证据证明它们使用 Gemini 原生视频协议、OpenAI 视频协议或某个固定异步任务结构。目录中的 “Gemini / Omni” 是阅读分组,不是协议结论;执行时仍需以实时模型广场为准。

名称不是字段说明fastno-waterv2v 只能帮助识别模型,不能单独证明速度、水印策略、视频输入字段或输出权利。

Omni Metadata

omni-fast

已确认公开元数据中存在该模型名。提交前仍需确认协议标签、创建 URL、查询规则、必填字段、价格和输出格式;不要因为 fast 自动缩短轮询超时或提高查询频率。

Omni Metadata

omni-fast-no-water

已确认公开元数据中存在该名称。no-water 不构成无水印结果、授权范围或合规性的保证;实际输出仍须人工检查,素材和作品使用仍受相应权利与平台规则约束。

Omni Metadata

omni-v2v

名称提示可能与视频到视频有关,但未达到 E4。只有模型详情明确给出视频输入字段、上传方式、格式、大小、时长和创建路径时,才可以准备非敏感测试素材;否则停止。

Omni Metadata

omni-v2v-no-water

同时包含 v2vno-water 仍只是模型名。不得继承 omni-v2v 的未知字段,也不得承诺输出无水印;必须把它作为独立模型完成价格、输入、路径、状态和结果验收。

Grok Video

Grok 视频目前只有模型标签证据

公开模型目录中可见 Grok 视频名称和视频相关标签,可以建立候选模型清单;尚不能从标签推出精确创建路径、素材字段、时长、宽高比、任务状态或结果结构。

Grok Metadata

grok-video

使用前逐项抄录当前模型详情中的模型 ID、端点、价格和必填参数。若只看到 openai-video 标签而没有完整任务说明,停止,不使用通用模板进行付费探测。

Grok Metadata

grok-video-1.5

版本号不表示与 grok-video 请求兼容。它需要独立完成同一套能力门槛;不要复用另一个 Grok 模型的路径、参数、状态映射或价格。

Task Lifecycle

异步任务的安全执行顺序

  1. 01预检

    锁定模型、分组、价格、创建与查询映射,所有占位符必须清零。

  2. 02提交一次

    记录本地请求标识和时间,客户端 POST 自动重试设为 0。

  3. 03保存原响应

    立即持久化脱敏响应,按已确认字段提取任务 ID。

  4. 04有限轮询

    只查询已创建任务,使用退避间隔、总超时和明确终态。

提交结果不确定网络超时、连接中断或响应解析失败不表示任务没有创建。先查平台日志、消费记录和原响应;找不到唯一任务时停止,禁止自动再次 POST。

Status & Result

保留上游原值,再映射业务状态

不同渠道可能使用不同字段名和值。本页只定义业务处理原则,不声称某组状态字面值是 MuxLLM 当前固定协议。

业务分类动作保护规则
等待 / 处理中按确认后的查询路径继续轮询使用退避间隔,不高频请求,不创建新任务
成功停止轮询,读取确认后的结果字段下载后验证 MIME、文件头、可解码性与实际时长
失败 / 取消停止轮询,保存错误摘要不自动重提;先判断参数、内容政策、余额或上游问题
未知值 / 缺字段保留原始响应,有限次数复查同一任务超过总超时后进入人工复核,不猜终态
结果 URL可能临时有效;下载 GET 可以有限重试,但下载失败不得重新创建视频。
文件验证检查响应类型、文件头、容器可解析、视频轨道存在和文件非空,再报告完成。
未知结果只有文件 ID、空数组或未知字段时保存脱敏响应并停止,不自动付费重试。

Cost & Safety

视频任务必须先设费用与重试边界

单次预算

确认当前模型、分组、规格和实时价格;首次只提交一个短任务。

无映射停止

创建 URL、查询规则、任务 ID、状态字段或结果字段任一不清楚都不提交。

素材权利

只上传有权处理的图片或视频,移除不必要的定位、人物和业务敏感信息。

禁止自动付费重试

创建 POST 最多一次;轮询和下载只针对同一任务,不转换成新的生成请求。

Troubleshooting

视频错误按创建、查询和下载三段排查

现象优先检查处理
创建 401 / 403认证头、Token 分组、模型可用范围与余额修正权限,不用其他模型轮试
创建 404路径是否来自当前模型详情,Base URL 是否重复停止;不要在两套候选路径之间自动切换
创建 400请求格式、必填字段和所有可选参数回到经确认的最小请求,逐项核对
创建超时 / 5xx日志、消费记录、是否已有任务 ID不重新创建,先寻找原任务
查询不到任务任务 ID、查询前缀、认证和原创建响应只修正查询,不重发创建
长期未知状态原始状态值、轮询间隔、总超时与上游负载进入人工复核,不猜成功或失败
结果 URL 失败有效期、HTTP 状态、内容类型和文件结构有限重试下载 GET,不重发生成 POST

Next

用一次提交上限执行视频任务

完整填写模型映射和预算后,再使用带停止条件的 AI 视频 Skill Prompt。