主题
创建视频
所有请求均需携带 API Key。基础地址及响应格式见通用约定。
创建视频生成任务
作用:使用配置接口返回的稳定线路编码和模型编码创建视频生成任务。
请求:POST /generation/create/video
Content-Type:application/json
输入参数
表格较宽时,可左右滑动查看完整内容。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| channel | string | 是 | videoConfig[].channel 返回的稳定线路编码 |
| model | string | 是 | 所选线路 models[].model 返回的稳定模型编码 |
| prompt | string | 是 | 视频生成提示词,最长 15000 字符,部分线路可能有更短限制 |
| aspectRatio | string | 是 | 画幅比例,必须从所选模型 aspectRatios 中选择 |
| quality | string | 是 | 质量/清晰度档位,必须从所选模型 qualities[].quality 中选择 |
| duration | integer | 是 | 视频时长,单位:秒,必须满足所选模型 duration 能力 |
| mode | string | 否 | 生成模式,必须从所选模型 modes 中选择 |
| inputImages | array<string> | 否 | 输入参考图片公网 URL 列表,最多 inputImagesMax 条;元素不能为空字符串 |
| inputVideos | array<string> | 否 | 输入参考视频公网 URL 列表,最多 inputVideosMax 条;元素不能为空字符串 |
| inputAudios | array<string> | 否 | 输入参考音频公网 URL 列表,最多 inputAudiosMax 条;元素不能为空字符串 |
mode 规则
表格较宽时,可左右滑动查看完整内容。
| 模式 | 说明 | 素材要求 |
|---|---|---|
| text2video | 文生视频 | 不允许传入参考图片、参考视频或参考音频 |
| image2video | 全能参考 | 至少传入 1 个参考素材,可按模型能力组合参考图片、参考视频、参考音频 |
| frames2video | 首尾帧生视频 | 必须正好传入 2 张参考图片,顺序为首帧、尾帧 |
mode必须包含在所选模型的modes中。- 未显式传入
mode时:存在任意参考图片、参考视频或参考音频则按image2video处理,否则按text2video处理。
可运行的测试请求
先设置环境变量 AISTARSLAB_API_KEY。该请求不扣生成积分。
bash
curl 'https://api.video.aistarslab.com/openapi/generation/create/video' \
-H "Authorization: Bearer $AISTARSLAB_API_KEY" \
-H 'Content-Type: application/json' \
--data '{"channel":"test","model":"test-video","prompt":"测试生成","aspectRatio":"16:9","quality":"720p","duration":5,"mode":"text2video"}'正式请求结构示例
这是正式任务的结构示例,模型和素材 URL 须替换为实际可用值。可直接运行的测试请求见上方。
json
{
"channel": "12",
"model": "example-video-model",
"prompt": "海边日落,镜头缓慢向前推进,背景 @图片1,画面节奏参考音乐 @音频1",
"aspectRatio": "16:9",
"quality": "720p",
"duration": 10,
"mode": "image2video",
"inputImages": [
"https://example.com/reference.jpg"
],
"inputAudios": [
"https://example.com/reference.mp3"
]
}返回参数
HTTP 200 且 response.code=0 时,response.data:
表格较宽时,可左右滑动查看完整内容。
| 属性名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| taskId | string | 是 | 任务业务 ID,用于查询状态和结果 |
| type | integer | 是 | 生成类型编码,视频为 2 |
| status | integer | 是 | 任务状态编码 |
| costCredits | integer | 是 | 本次任务实际消耗积分 |
创建响应示例
json
{
"code": 0,
"msg": "success",
"data": {
"taskId": "test_video_example",
"type": 2,
"status": 2,
"costCredits": 0
}
}保存实际返回的 data.taskId,继续查询任务。status=2 表示已受理并执行中,不表示生成已完成。测试查询固定返回成功,真实任务可能等待、执行或失败。