Skip to main content
Veo-3.1 旧接入方案故障通知veo-3.1 系列旧接入方案自 2026 年 5 月 14 日起出现故障,当前暂时无法使用。请暂停按本文示例创建新的异步视频任务,恢复时间以网站公告和控制台通知为准。
异步端点: https://api2.laozhang.ai/v1/videos调用方式: 三步骤(创建任务 → 查询状态 → 获取视频)优势: 更稳定 | 任务队列 | 支持长时任务 | 失败计费以控制台记录为准

为什么选择异步 API?

更高稳定性

基于任务队列,避免长连接超时问题

失败计费以控制台记录为准 ⭐

重大优势:任何原因失败都计费以控制台记录为准
  • ✓ 内容违规 → 计费以控制台记录为准
  • ✓ 队列超时 → 计费以控制台记录为准
  • ✓ 生成失败 → 计费以控制台记录为准
同步 API 的异常计费以控制台订单状态为准。

灵活轮询

可随时查询任务状态和进度

批量处理

适合批量生成、后台任务处理

同步 vs 异步对比

推荐使用异步 API,特别是在生产环境或需要批量生成视频时,稳定性更有保障。

快速开始

异步调用分为三个步骤:
1

创建视频任务

POST 请求创建任务,获取任务 ID
2

查询任务状态

定期轮询查询生成进度
3

下载视频

任务完成后获取视频文件

完整示例

API 端点详解

1. 创建视频任务

POST https://api2.laozhang.ai/v1/videos创建一个新的视频生成任务

请求参数

可用模型

模型命名规则:
  • landscape = 横屏(16:9)
  • fast = 快速版(更成本较低)
  • fl = 支持帧转视频(图生视频)
首尾帧功能图生视频模型(带 -fl 后缀)支持传入 2 张图片:
  • 第一张:视频开始帧
  • 第二张:视频结束帧
API 会自动生成从开始帧到结束帧的平滑过渡动画。

响应字段

2. 查询任务状态

GET https://api2.laozhang.ai/v1/videos/{video_id}查询视频生成任务的当前状态

路径参数

响应字段

任务状态说明

3. 获取视频内容

GET https://api2.laozhang.ai/v1/videos/{video_id}/content获取已完成视频的实际内容

路径参数

响应字段

重要提示视频 URL 有效期通常为 24 小时,请及时下载保存到本地!

完整代码示例

Python 示例(含轮询逻辑)

JavaScript/Node.js 示例

最佳实践

推荐轮询间隔:5-10 秒
原因:
  • 视频生成通常需要 2-5 分钟
  • 5-10 秒可以及时反馈进度
  • 避免过于频繁的请求
推荐超时设置:10 分钟(600秒)
注意:
  • 任务超时不会自动取消
  • 可以稍后继续查询同一个 video_id
  • 任务有效期为 24 小时
建议重试逻辑:
重试场景:
  • ✓ 网络错误 → 重试
  • ✓ 服务繁忙 (503) → 重试
  • ✗ 内容违规 → 不要重试,修改提示词
  • ✗ 余额不足 → 不要重试,确认账户额度后再试
并发控制建议:
建议:
  • 创建任务:可以高并发(10-30个)
  • 查询状态:建议并发数 ≤ 10
  • 下载视频:建议并发数 ≤ 5

定价说明

异步 API 与同步 API 价格完全相同,按次计费。
计费规则:
  • ✓ 计费以控制台订单状态为准
  • 异常、超时、取消、内容安全问题均以控制台记录为准
  • 查询状态是否计费以控制台记录为准
异步API计费提示:任何异常状态都应回到控制台订单和账单记录确认;如记录异常,请联系客服复核。

常见问题

任务有效期:24 小时
  • 创建任务后,24 小时内可随时查询任务状态
  • 视频生成完成后,文件保存 24 小时
  • 超过 24 小时后,任务和视频将被自动清理
建议:
  • 视频生成完成后立即下载
  • 不要依赖服务器长期存储
可能的原因:
  1. video_id 错误 - 检查是否复制完整
  2. 任务已过期 - 超过 24 小时
  3. 网络问题 - 重试请求
解决方法:
可以混用,完全独立两个 API 系统完全独立:
  • 不同的端点
  • 不同的调用方式
  • 相同的定价
  • 共享同一个 API Key 和余额
使用建议:
  • 快速测试 → 使用同步 API
  • 生产环境 → 使用异步 API(更稳定)
  • 批量生成 → 使用异步 API
根据需求选择:

错误处理

常见错误码

错误响应格式

技术支持

需要帮助?

如有问题,欢迎联系我们:

下一步

同步 API

查看同步调用方式(OpenAI 兼容)

代码示例

查看更多应用示例

模型概览

了解 Veo-3.1 模型详情

常见问题

查看更多问题解答