v1

latestOpenAPI 3.0.12026-07-265535227.4 KB
AI 服务/视频生成

生成视频

接口说明:提交视频生成任务,可传入参考图片、视频、音频。任务异步执行,返回 taskId 用于轮询结果。

调用本接口前,请先请求「视频生成模型」接口(GET /api/ai/models/video/generation),获取当前可用的模型列表及各模型的参数限制(分辨率、时长、宽高比、参考媒体约束与价格),再据此填写本接口参数。

post/api/ai/video/generations

Request body

modelstring required

视频生成模型名称。先调用「视频生成模型」接口(GET /api/ai/models/video/generation),传入其返回的 data[n].name;各模型支持的分辨率、时长、宽高比与价格以该接口返回为准。

promptstring required

提示词,长度 1-4000 字符

imagesstring[]

参考图片 URL 列表。最大数量与格式限制随模型而不同,以「视频生成模型」接口返回的 data[n].maxInputImagesdata[n].inputConstraints 为准。

videosstring[]

参考视频 URL 列表。是否支持视频输入,以及数量、格式、时长、大小限制随模型而不同,以「视频生成模型」接口返回的 data[n].modesdata[n].inputConstraints 为准。

audiosstring[]

参考音频 URL 列表。是否支持音频输入,以及数量、格式、时长、大小限制随模型而不同,以「视频生成模型」接口返回的 data[n].modesdata[n].inputConstraints 为准。

resolution'480p' | '720p' | '1080p'

视频分辨率。可选值随模型而不同,以「视频生成模型」接口返回的 data[n].resolutions 为准。

ratiostring

视频宽高比。可选值随模型而不同,以「视频生成模型」接口返回的 data[n].aspectRatios 为准。

durationnumber

视频时长(秒)。可选范围随模型而不同,以「视频生成模型」接口返回的 data[n].durations 为准。

Response

请求已被服务处理。业务是否成功以响应体 code === 0 为准。

codeinteger required

业务状态码。0 表示成功,非 0 表示业务错误。

messagestring required

响应消息。

requestIdstring

请求 ID。

timestampinteger

错误响应时间戳,Unix 毫秒。