GetRouter文档
  • 简体中文

    • 视频

    视频生成是异步操作。先创建任务并保存 ID，然后轮询任务状态，完成后下载结果。

    通用视频接口：

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

    创建视频任务

    /v1/videos 接受 Multipart Form Data：

    curl https://getrouter.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=MODEL_ID" \
  -F "prompt=一架纸飞机飞过安静的现代办公室" \
  -F "seconds=8"

    兼容模型进行图生视频时，可以上传参考文件：

    curl https://getrouter.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=MODEL_ID" \
  -F "prompt=加入缓慢推进的镜头和轻微动态" \
  -F "seconds=8" \
  -F "[email protected]"

    成功响应包含 id 等任务标识，以及状态、进度、模型、时长或时间戳等可用元数据。

    查询任务状态

    curl https://getrouter.ai/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

    请使用合理的轮询间隔。任务进入成功或失败的终止状态后停止轮询。

    下载结果

    任务完成后：

    curl -L https://getrouter.ai/v1/videos/TASK_ID/content \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --output result.mp4

    推荐任务流程

    1. 提交前验证模型、时长和输入。
    2. 只提交一次任务。
    3. 持久化返回的 Task ID。
    4. 使用退避策略轮询，不要高频查询。
    5. 记录终止错误以便排查。
    6. 任务完成后及时下载内容。
    Warning

    状态查询超时时，不要立即创建替代任务。请先使用原 Task ID 查询，避免重复生成和重复计费。

    服务商专用视频接口

    API 还包含 Kling 等服务商兼容的视频路径，不同接口的请求字段和任务响应结构不同。新接入优先使用通用 /v1/videos 流程，除非模型或现有客户端明确要求专用路径。

    当前公开路径和 Schema 请查看 接口参考。

    费用控制

    视频费用可能取决于模型、时长、分辨率、质量和输入类型。请查看价格页面，并先用短任务测试，再运行自动化批量生成。

    下一步