视频生成与任务查询

文生视频、图生视频、关键帧、状态查询、同步等待与帧数建议。

这里单独放 Agnes 视频能力，避免把视频的异步任务、状态查询、帧数、关键帧说明塞进 SKILL.md。 官方文档入口：https://agnes-ai.com/doc。

一、视频调用入口

POST /v1/videos
GET  /v1/videos/{task_id}

二、文生视频

curl -X POST http://localhost:9890/v1/videos \
  -H "Content-Type: application/json" \
  -d '{
    "model": "agnes-video-v2.0",
    "prompt": "一只橘猫戴着墨镜走过霓虹灯街道，电影感镜头，雨夜反光，缓慢推进镜头。",
    "width": 1152,
    "height": 768,
    "num_frames": 121,
    "frame_rate": 24
  }'

三、图生视频

{
  "model": "agnes-video-v2.0",
  "prompt": "让画面中的人物缓慢转头，背景光影轻微移动，电影感，动作自然。",
  "image": "https://example.com/input.jpg",
  "width": 1152,
  "height": 768,
  "num_frames": 121,
  "frame_rate": 24
}

四、多图 / 关键帧视频

{
  "model": "agnes-video-v2.0",
  "prompt": "从第一张图平滑过渡到第二张图，镜头自然推进，光影连续，电影感。",
  "images": [
    "https://example.com/frame_start.jpg",
    "https://example.com/frame_end.jpg"
  ],
  "mode": "keyframes",
  "width": 1152,
  "height": 768,
  "num_frames": 121,
  "frame_rate": 24
}

五、状态查询

curl http://localhost:9890/v1/videos/<task_id>

这个接口用于 Web Studio、人工排查或明确需要查询单个任务状态的场景。异步任务提交后，通常建议在 Web Studio 的 Jobs / Assets 页面查看进度与结果。

六、视频 URL 字段说明

Agnes 实测完成后可能把视频地址放在 remixed_from_video_id 字段。网关会把 video_url、remixed_from_video_id、url、output_url 这些常见字段统一归一化到 video_url。

七、同步等待完成（非推荐）

{
  "model": "agnes-video-v2.0",
  "prompt": "未来城市上空的无人机航拍镜头，霓虹灯，雨夜，电影感。",
  "width": 1152,
  "height": 768,
  "num_frames": 121,
  "frame_rate": 24,
  "wait_for_completion": true
}

八、常用参数建议

num_frames 一般使用 8n+1 形式，常见值：81、121、161、241、441。当前网关上限为 441 帧；默认 24fps 下约 18.4 秒。

在 GitHub 查看原始文档 ↗