superouter 视频生成

概述

该技能面向 superouter 平台 API，而非直接对接 Jimeng 上游服务。

默认模型：seedance-2.0-v1，模型列表可从服务端获取。

当用户希望执行以下操作时，使用此技能：

• 上传有序的参考素材（reference assets）
• 提交异步视频生成任务
• 使用平台返回的 taskId 查询任务状态
• 从平台返回的真实 URL 下载最终生成的视频

当前平台暴露的接口如下：

• POST /v1/video/assets/upload
• POST /v1/video/omni-reference/task/submit
• GET /v1/video/omni-reference/task/query
• GET /v1/video/models
• GET /me/balance
• GET /me/tasks

前置条件

• SUPER_KEY 必须是 superouter 客户端 API 密钥
• 若平台返回 401 或 403，立即中止并告知用户：客户端密钥无效或已被禁用
• 短剧类生成的默认宽高比为 9:16，仅在用户未指定宽高比时生效
• 默认模型为 seedance-2.0-v1；不得自行添加任何影响生成结果的字段

当前平台规则

提示词（Prompt）

• prompt 最大长度：2000 字符

支持的文件类型

• 图像：jpg jpeg png webp gif bmp
• 视频：mp4 mov m4v
• 音频：mp3 wav

文件限制

• 单个文件最大体积：30MB
• 每个任务引用的全部素材总大小上限：100MB
• 图像最短边最小尺寸：320px
• 图像长边与短边比例上限：3:1
• 视频最长时长：15s
• 音频最长时长：15s

Seedance 提交限制

• aspectRatio：支持 1:1、4:3、3:4、16:9、9:16、21:9
• resolution：仅支持 720p
• duration：取值范围为 4 至 15
• generatingCount：当前仅支持 1

计费说明

针对 seedance-2.0-v1 模型：

• 无视频参考时：5 积分 / 秒
• 存在任意视频参考时：10 积分 / 秒
• 若未提供 duration，按 4 秒估算费用

upload 和 query 接口当前不扣除积分。

素材选择原则

• 仅上传对当前镜头实际起作用的人物或场景参考
• 尽可能精简并严格保持参考素材列表的顺序
• 若服装连贯性至关重要，请显式添加服装参考，而非依赖假设
• 视频生成对参考顺序高度敏感，请确保 references[] 严格遵循业务逻辑顺序

工作流程

1. 提交前检查余额

使用平台余额，而非上游配额：

curl "http://superouter.nesports.top/me/balance" 
  -H "Authorization: Bearer ${SUPER_KEY}"

提交前预估所需积分：

• 若提供了 duration，则使用该值；否则默认为 4
• 若任一参考素材为视频，则乘以 10
• 否则乘以 5

若余额不足，请在上传/提交前中止，并向用户说明预估费用。

2. 验证本地输入

在任何上传操作之前：

• 确认所有引用的本地文件均真实存在
• 确认提示词长度 ≤ 2000
• 不得自行编排文件顺序
• 占位符名称需与参考素材顺序严格对齐

若提示词中使用了命名占位符（例如 <<>>），请确保对应 references[].name 的值完全一致。

3. 优先上传素材

将每个本地文件上传至平台，并收集返回的 fileId。

curl --request POST "http://superouter.nesports.top/v1/video/assets/upload" 
  --header "Authorization: Bearer ${SUPER_KEY}" 
  --form "file=@/absolute/path/to/reference-1.png"

响应示例：

{
  "code": "200",
  "message": "Success",
  "result": {
    "fileId": "asset_xxx",
    "fileName": "reference-1.png",
    "contentType": "image/png",
    "mediaType": "image",
    "sizeBytes": 12345,
    "status": "uploaded"
  }
}

规则：

• 必须始终保存返回的 fileId
• 同一客户端重复上传相同文件可能返回已存在的 fileId
• 除非用户明确要求编写脚本进行多次连续上传，否则不得假设单次上传请求可接收多个文件
• 若文件内容未变，可复用此前保存的 fileId 进行后续提交

4. 提交任务

向平台提交任务，而非直接提交至 Jimeng。

curl --request POST "http://superouter.nesports.top/v1/video/omni-reference/task/submit" 
  --header "Authorization: Bearer ${SUPER_KEY}" 
  --header "Content-Type: application/json" 
  --data '{
    "model": "seedance-2.0-v1",
    "prompt": "让 @1 中的人物根据 @2 的内容说话。",
    "references": [
      { "fileId": "asset_image_1", "name": "Image1" },
      { "fileId": "asset_audio_1", "name": "Audio1" }
    ],
    "aspectRatio": "9:16",
    "resolution": 720,
    "duration": 4,
    "generatingCount": 1
  }'

规则：

• 严格保持 references[] 的预期顺序
• 首个参考即第一个逻辑素材，第二个参考即第二个逻辑素材，依此类推
• 不得自行指定 aspectRatio、resolution、duration 或 references[].name
• 默认采用异步提交行为；平台将返回 taskId
• 提交成功后，需向用户报告 taskId 及预估积分消耗

成功响应结构示例：

{
  "code": "200",
  "message": "Success",
  "result": {
    "taskId": "task_xxx",
    "status": "submitted"
  }
}

5. 查询任务状态

使用平台返回的 taskId。

curl --get "http://superouter.nesports.top/v1/video/omni-reference/task/query" 
  --header "Authorization: Bearer ${SUPER_KEY}" 
  --data-urlencode "taskId=task_xxx"

可能的状态值包括：

• submitted
• processing
• completed
• failed

完成状态响应示例：

{
  "code": "200",
  "message": "Success",
  "result": {
    "taskId": "task_xxx",
    "status": "completed",
    "errorMessage": null,
    "videos": [
      {
        "url": "https://..."
      }
    ]
  }
}

规则：

• 返回的 videos[].url 即真实下载地址，应直接提供给用户
• 除非用户明确要求将文件保存至本地，否则不得代理下载
• 若状态为 processing，请清晰告知用户并停止轮询，除非用户明确要求持续轮询
• 若状态为 failed，请返回 errorMessage；平台可能会自动退款

6. 可选：任务列表查询

若用户希望查看近期任务列表，而非单个任务状态：

curl "http://superouter.nesports.top/me/tasks?limit=50" 
  -H "Authorization: Bearer ${SUPER_KEY}"

可用于查看近期平台任务。平台在列出任务时可能会刷新未完成任务的状态。

提示词与顺序规则

• 参考素材列表顺序应与用户期望模型读取的顺序完全一致
• 仅当用户请求中明确命名了参考素材时，才使用 @1 类占位符
• 若用户仅提供未命名文件，请保持其原始顺序，不得自行赋予语义化名称
• 若用户要求重写镜头提示词，请确保素材引用与最终 references[] 保持一致

固定规则

• 仅使用 superouter 平台 API
• 仅默认设置模型；对于显著影响输出结果但缺失的生成参数，必须主动向用户询问
• 在获得平台返回的 taskId 前，不得声称任务已成功提交
• 提交后默认不等待任务完成
• 若服务不可达，请提示用户检查 superouter API 是否正常运行