xmsmartlink Docs

外观

视频系列总览 ​

xmsmartlink Docs 的视频相关接口按模型系列分别组织，包括统一视频接口、Kling、Vidu、Sora / Hailuo、Veo、Seedance、Seedance-2 和 Hunyuan。大多数视频模型采用异步任务模式：先提交生成请求，服务端返回任务 ID，再通过查询接口轮询状态，任务完成后读取结果地址，或在特定模型下继续拉取内容。

由于不同模型系列的请求字段和能力侧重点不同，建议先确定要接入的模型系列，再围绕任务状态管理、失败重试和结果下载设计接入流程。

当前分类 ​

  • 统一视频接口：适合希望使用统一请求格式接入视频生成能力的场景
  • Kling 视频：包括文生视频、图生视频、Omni Video 及其查询接口
  • Vidu 视频：包括文生视频、图生视频、首尾帧视频、参考图视频及任务查询
  • Sora / Hailuo 视频：包括任务创建、任务查询和视频内容获取
  • Veo 视频：包括长任务创建与操作状态查询
  • Seedance 视频：通过统一视频接口接入 Seedance 任务
  • Seedance-2 视频：包括原生任务创建、查询、取消以及提示词与素材引用说明
  • Hunyuan 视频：包括任务创建与查询接口

选择建议 ​

  • 希望统一接入多种视频生成能力：优先查看“统一视频接口”
  • 已明确接入 Kling：优先查看 “Kling 视频”
  • 已明确接入 Vidu：优先查看 “Vidu 视频”
  • 需要 Sora 或 Hailuo 相关能力：优先查看 “Sora / Hailuo 视频”
  • 需要 Veo 长任务接口：优先查看 “Veo 视频”
  • 需要 Seedance-2 原生任务接口：优先查看 “Seedance-2 视频”
  • 需要 Hunyuan 视频任务接口：优先查看 “Hunyuan 视频”

接入共性 ​

  • 大多数接口采用“创建任务 + 轮询结果”的异步模式
  • 不同模型系列的请求字段、任务状态和结果结构可能不同
  • 部分模型直接在查询接口中返回结果 URL
  • 部分模型提供单独的视频内容获取接口

常见入口 ​

  • POST /v1/video/generations
  • GET /v1/video/generations/{task_id}
  • POST /kling/v1/videos/text2video
  • POST /vidu/ent/v2/text2video
  • POST /v1/videos
  • GET /v1/videos/{video_id}
  • POST /v1/task/create
  • GET /v1/task/get/{id}

参考接口文档 ​

接入视频相关接口时，建议重点确认任务成功态、失败态、结果字段、视频地址有效期，以及目标模型是否提供专用内容获取接口。