视频

视频生成能力，支持文生视频、图生视频。创建任务时 model 传模型名称（与模型列表 name 一致），提交后通过任务查询获取结果链接。

视频模型

模型名称	介绍
`BytePlus-Seedance-1.5-pro`	文生视频，支持 duration、callbackUrl 等
`MiniMax-Hailuo-2.3`	图生视频，支持 image_url、callbackUrl、callbackSecret

2.1 文生视频（BytePlus-Seedance 示例）

向 /v1/videos/generations 发送 POST，model 填模型名称（如 BytePlus-Seedance-1.5-pro），可选 duration（秒）、callbackUrl。

curl -X POST "https://testing.amags.keplerjai.com/v1/videos/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model": "BytePlus-Seedance-1.5-pro",
    "prompt": "亚洲古风美女月下跳舞，10秒视频",
    "duration": 5
  }'

成功响应：{"resultCode":"OK","task_id":67}。

2.2 图生视频（带参考图与回调，MiniMax-Hailuo 示例）

传入 image_url 作为首帧或参考图，可选 callbackUrl、callbackSecret 用于任务完成回调。

curl -X POST "https://testing.amags.keplerjai.com/v1/videos/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "让图中人物动起来，微笑挥手",
    "image_url": "https://example.com/first-frame.jpg",
    "duration": 6,
    "callbackUrl": "https://your-server.com/callback",
    "callbackSecret": "your-callback-secret"
  }'

参数速查（POST /v1/videos/generations）

字段	类型	必填	说明
`model`	string	是	模型名称（与模型列表 name 一致）
`prompt`	string	是	提示词
`duration`	int	否	视频时长（秒），未传用模型默认值
`image_url`	string	否	图生视频参考图 URL
`image_urls`	string[]	否	多张参考图 URL
`imageBase64`	string	否	参考图 Base64 / data URL
`imageBase64List`	string[]	否	多张参考图 Base64
`callbackUrl`	string	否	任务完成回调地址
`callbackSecret`	string	否	回调鉴权密钥

任务查询与结果地址

GET /v1/tasks/:id，当 task.status 为 succeeded 时，task.resultUrl 为视频可访问 URL。详见概览 · 任务查询与取消。

视频任务成功后，平台可能先将供应商临时地址写入 resultUrl，转存到 OSS 后再更新为平台地址；转存进度见任务字段 resultStorageStatus（transferring / completed / failed）及 resultStorageError。

Note

可在「模型测试」页选择视频生成、填写 API Key 与提示词进行体验。