AI 模型接口视频（Videos）
创建视频生成任务
接口
POST /v1/video/generations
请求头
| Header | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <token> |
Content-Type | 是 | application/json 或 multipart/form-data |
Accept | 建议 | application/json |
请求参数
application/json 或 multipart/form-data
| 字段 | 位置 | 类型 | 说明 |
|---|---|---|---|
model | body | string | 模型 ID，用于模型/渠道路由 |
prompt | body | string | 文本提示词 |
image | body | string | 单张参考图 URL，支持公网 HTTP(S) 图片地址 |
images | body | string[] | 多张参考图 URL，支持公网 HTTP(S) 图片地址 |
input_reference | body | string | 参考图别名，内部会按 image / images 统一处理 |
material_id | body | string | 平台素材 ID，仅支持素材库能力的渠道 |
material_ids | body | string[] | 平台素材 ID 列表，仅支持素材库能力的渠道 |
size | body | string | 尺寸或渠道方画幅参数 |
resolution | body | string | 输出分辨率 |
ratio | body | string | 输出比例 |
aspect_ratio | body | string | 输出比例别名 |
duration | body | integer | 视频时长（秒） |
seconds | body | string | 视频时长别名（秒） |
generate_audio | body | boolean | 是否生成音频 |
watermark | body | boolean | 是否添加水印 |
seed | body | integer | 随机种子 |
metadata | body | object | 扩展参数，透传给上游适配器 |
响应参数
application/json
| 字段 | 类型 | 说明 |
|---|---|---|
task_id | string | 任务 ID |
id | string | 任务 ID 别名 |
status | string | 任务状态 |
model | string | 模型 ID |
created_at | integer | 创建时间戳 |
metadata.url | string | 完成后的结果视频地址（如有） |
error.message | string | 失败原因 |
error.code | string | 失败码 |
状态值
queuedin_progresscompletedfailedunknown
说明
- 对外接口不再暴露
channel_id，渠道选择由 token 绑定与模型路由决定。 image、images、input_reference支持公网 HTTP(S) 图片 URL，后端会归一化后交给对应适配器。material_id、material_ids会保留在请求层，是否透传到上游由具体渠道决定。resolution、ratio、aspect_ratio、duration、seconds、generate_audio、watermark、seed会进入任务适配器的参数转换逻辑。- 返回的
task_id可用于查询任务状态与结果。