KW 视频 API

本站渠道配置包含 kw-video-v2、kw-video-v2-fast、kw-video-v2.5。这些是本站模型 ID，不应直接套用火山引擎模型的权限、参数范围或价格。

当前接入状态：绑定待核对

2026-10-09 发布前复核时，KW 模型仍有启用的渠道能力记录，但当前公开目录未展示 video／vip 分组模型；需要先核对分组开放与令牌权限。此外，seedance-kw 1.0.5 任务插件已启用，但 KW 视频渠道仍为 DoubaoVideo（类型 54），没有绑定该插件。目录可见只说明模型已配置，不能据此确认新版插件路由已经可用。本轮未发起视频生成测试。

在管理员完成插件绑定和端到端验证前，以下示例用于说明目标接口格式，不作为当前调用成功的保证。

模型与协议

模型 ID	目标协议	验证状态
kw-video-v2	OpenAI 视频任务	目录已配置，插件绑定待核对
kw-video-v2-fast	OpenAI 视频任务	目录已配置，插件绑定待核对
kw-video-v2.5	OpenAI 视频任务	目录已配置，插件绑定待核对

插件声明 POST /v1/videos，查询和下载见通用视频 API。插件还声明原生路径 /seedance-kw/api/v3/contents/generations/tasks，其请求内容与状态枚举不同，不与 OpenAI 格式混用。

绑定完成后的最小示例

curl --fail-with-body -sS "https://newapi.fq-hx.com/v1/videos" \
  -H "Authorization: Bearer $NEWAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kw-video-v2",
    "prompt": "清晨山谷，薄雾缓慢移动，镜头固定",
    "seconds": "5",
    "metadata": {
      "resolution": "720p",
      "ratio": "16:9",
      "generate_audio": false
    }
  }'

时长、分辨率和音频取值需按实际账号、模型和上游限制验证。插件配置中存在分辨率档位，不等于每个模型已实测支持全部档位。

参考素材

使用 metadata.content 中的图片或视频 URL；插件不接收 multipart 文件上传。使用有权调用且上游可读取的素材，不使用很快过期的预览地址。不要把火山引擎 asset:// 资产直接用于 KW，除非 KW 上游已明确支持。

管理员上线顺序

1. 核对渠道应绑定 seedance-kw，使用任务插件渠道（类型 61）选择已启用版本；不在仍有进行中任务的旧渠道上直接替换执行方式。
2. 配置目标模型、分组与本站价格，并核对上游请求格式。
3. 用独立测试令牌确认 /v1/models 可见；提交一个短视频任务，保存公开 id。
4. 查询终态、通过 /content 下载，再核对实际用量和最终扣费。
5. 完成后更新本文和模型目录的验证日期；失败时保留任务记录，按错误信息排查。

日常监控使用状态接口和模型目录，不自动创建视频任务。价格说明见模型与计费。