视频生成概览

视频生成采用异步任务模式：创建任务后保存返回的任务 ID，再查询状态或等待回调。

端点

端点	方法	说明
`/v1/videos`	POST	创建视频任务
`/v1/videos/{id}`	GET	查询任务
`/v1/videos/{id}`	DELETE	取消任务

任务流程

从模型目录选择支持目标能力的视频模型。
调用 POST /v1/videos 创建任务。
保存响应中的任务 ID。
轮询任务或按模型能力配置 Webhook。
成功后读取结果地址，并在用量日志查看扣费明细。

计费规则

一个 API Key 可以访问全平台视频模型。请求按所选模型的当前价格计费；每个成功请求都会生成扣费明细，失败任务不会产生扣费。

最小示例

bash

curl https://api.layso.ai/v1/videos \
  -H "Authorization: Bearer $LAYSO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "video-model-id",
    "prompt": "A cinematic shot of clouds moving over mountains"
  }'

模型 ID、分辨率、时长和参考图等参数以控制台模型目录中的当前说明为准。