Skip to main content
异步端点: https://api.yelinai.com/v1/videos调用方式: 三步骤(创建任务 → 查询状态 → 获取视频)优势: 更稳定 | 任务队列 | 支持长时任务 | 失败不扣费

为什么选择异步 API?

更高稳定性

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

失败不扣费 ⭐

重大优势:任何原因失败都不扣费
  • ✓ 内容违规 → 不扣费
  • ✓ 队列超时 → 不扣费
  • ✓ 生成失败 → 不扣费
同步API只要请求成功(HTTP 200)就扣费,即使最终生成失败!

灵活轮询

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

批量处理

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

同步 vs 异步对比

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

快速开始

异步调用分为三个步骤: 1 创建视频任务 POST 请求创建任务,获取任务 ID 2 查询任务状态 定期轮询查询生成进度 3 下载视频 任务完成后获取视频文件

完整示例

步骤1: 创建任务(文生视频) 步骤1: 创建任务(图生视频 - 单图) 步骤1: 创建任务(图生视频 - 首尾帧) 步骤2: 查询状态 步骤3: 获取视频

API 端点详解

1. 创建视频任务

POST https://api.yelinai.com/v1/videos创建一个新的视频生成任务

请求参数

可用模型

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

响应字段

2. 查询任务状态

GET https://api.yelinai.com/v1/videos/{video_id}查询视频生成任务的当前状态

路径参数

响应字段

任务状态说明

3. 获取视频内容

GET https://api.yelinai.com/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 价格完全相同,按次计费。 计费规则:
  • ✓ 仅在视频成功生成时收费(status = “completed”)
  • ✗ 失败、超时、取消不计费
  • ✗ 内容安全问题失败也不扣费(与同步API的重要区别⭐)
  • ✗ 查询状态不计费
异步API的重要优势:任何原因导致的失败都不会扣费,包括内容安全审核未通过。而同步API只要请求成功就会扣费,即使最终生成失败。

常见问题

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

错误处理

常见错误码

错误响应格式

技术支持

需要帮助?

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

下一步

同步 API

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

代码示例

查看更多应用示例

模型概览

了解 Veo-3.1 模型详情

常见问题

查看更多问题解答