Skip to content

创建视频 ​

所有请求均需携带 API Key。基础地址及响应格式见通用约定。

创建视频生成任务 ​

作用:使用配置接口返回的稳定线路编码和模型编码创建视频生成任务。

请求:POST /generation/create/video

Content-Type:application/json

输入参数 ​

表格较宽时,可左右滑动查看完整内容。

参数名类型必填说明
channelstring是videoConfig[].channel 返回的稳定线路编码
modelstring是所选线路 models[].model 返回的稳定模型编码
promptstring是视频生成提示词,最长 15000 字符,部分线路可能有更短限制
aspectRatiostring是画幅比例,必须从所选模型 aspectRatios 中选择
qualitystring是质量/清晰度档位,必须从所选模型 qualities[].quality 中选择
durationinteger是视频时长,单位:秒,必须满足所选模型 duration 能力
modestring否生成模式,必须从所选模型 modes 中选择
inputImagesarray<string>否输入参考图片公网 URL 列表,最多 inputImagesMax 条;元素不能为空字符串
inputVideosarray<string>否输入参考视频公网 URL 列表,最多 inputVideosMax 条;元素不能为空字符串
inputAudiosarray<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:

表格较宽时,可左右滑动查看完整内容。

属性名类型必填说明
taskIdstring是任务业务 ID,用于查询状态和结果
typeinteger是生成类型编码,视频为 2
statusinteger是任务状态编码
costCreditsinteger是本次任务实际消耗积分

创建响应示例 ​

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "taskId": "test_video_example",
    "type": 2,
    "status": 2,
    "costCredits": 0
  }
}

保存实际返回的 data.taskId,继续查询任务。status=2 表示已受理并执行中,不表示生成已完成。测试查询固定返回成功,真实任务可能等待、执行或失败。

星辰 AI · 图片与视频生成 API