Skip to main content
权限说明 SD2.0 暂未对所有用户开放。 如需开通调用权限,请联系YeLinAI 客服协助处理:hi@yelinai.com Base URL: https://api.yelinai.com 需要接入的接口: 2 个
  1. POST /v1/video/generations:创建视频生成任务
  2. GET /v1/video/generations/{task_id}:查询任务状态与获取结果 URL

接口流程

SD2.0 视频生成是异步任务接口。业务侧需要先创建任务,拿到 task_id 后轮询查询状态,直到任务完成并返回视频 URL。
  1. 创建任务
调用 POST /v1/video/generations,传入模型、提示词、视频参数和可选参考素材文件。
  1. 查询状态
调用 GET /v1/video/generations/{task_id},轮询 status
  1. 下载视频
status=completed 时,从响应中读取视频 URL 并下载 mp4。 常见状态流转:
失败时通常返回 failed,并在响应中包含 error 字段。

模型

创建任务

POST /v1/video/generations 创建 SD2.0 视频生成任务。

请求头

请求参数

文件引用语法

prompt 中按上传顺序引用文件:

文生视频示例

图片参考示例

多素材参考示例

首尾帧控制示例

创建响应

响应字段:

查询任务

GET /v1/video/generations/{task_id} 查询视频生成任务状态。

路径参数

查询响应

任务进行中:
任务完成:
任务失败:
响应字段:

下载视频

查询响应进入 completed 后,读取 video_url 并直接下载:
video_url 通常是临时签名 URL。生产环境建议任务完成后立即下载,或转存到自己的对象存储。

Python 完整示例

常见问题

文件上传有什么限制? 目前支持 jpg、png 图片格式和 mp4 视频格式。单个文件大小建议不超过 50MB。 如何正确引用上传的文件? 按文件上传顺序,图片使用 @IMG_1@IMG_2 引用,视频使用 @VID_1@VID_2 引用。 任务需要多久完成? 通常需要 20 - 30分钟,具体取决于视频时长和服务器负载。建议轮询间隔设为 20-30 秒。