https://api.yelinai.com/v1/videos调用方式: 三步骤(创建任务 → 查询状态 → 获取视频)优势: 更稳定 | 任务队列 | 支持长时任务 | 失败不扣费
为什么选择异步 API?
更高稳定性
基于任务队列,避免长连接超时问题失败不扣费 ⭐
重大优势:任何原因失败都不扣费- ✓ 内容违规 → 不扣费
- ✓ 队列超时 → 不扣费
- ✓ 生成失败 → 不扣费
灵活轮询
可随时查询任务状态和进度批量处理
适合批量生成、后台任务处理同步 vs 异步对比
推荐使用异步 API,特别是在生产环境或需要批量生成视频时,稳定性更有保障。
快速开始
异步调用分为三个步骤: 1 创建视频任务 POST 请求创建任务,获取任务 ID 2 查询任务状态 定期轮询查询生成进度 3 下载视频 任务完成后获取视频文件完整示例
步骤1: 创建任务(文生视频) 步骤1: 创建任务(图生视频 - 单图) 步骤1: 创建任务(图生视频 - 首尾帧) 步骤2: 查询状态 步骤3: 获取视频API 端点详解
1. 创建视频任务
POSThttps://api.yelinai.com/v1/videos创建一个新的视频生成任务
请求参数
可用模型
模型命名规则:
landscape= 横屏(16:9)fast= 快速版(更便宜)fl= 支持帧转视频(图生视频)
-fl 后缀)支持传入 2 张图片:
- 第一张:视频开始帧
- 第二张:视频结束帧
响应字段
2. 查询任务状态
GEThttps://api.yelinai.com/v1/videos/{video_id}查询视频生成任务的当前状态
路径参数
响应字段
任务状态说明
3. 获取视频内容
GEThttps://api.yelinai.com/v1/videos/{video_id}/content获取已完成视频的实际内容
路径参数
响应字段
重要提示视频 URL 有效期通常为 24 小时,请及时下载保存到本地!
完整代码示例
Python 示例(含轮询逻辑)
JavaScript/Node.js 示例
最佳实践
轮询间隔设置 推荐轮询间隔:5-10 秒- 视频生成通常需要 2-5 分钟
- 5-10 秒可以及时反馈进度
- 避免过于频繁的请求
- 任务超时不会自动取消
- 可以稍后继续查询同一个 video_id
- 任务有效期为 24 小时
- ✓ 网络错误 → 重试
- ✓ 服务繁忙 (503) → 重试
- ✗ 内容违规 → 不要重试,修改提示词
- ✗ 余额不足 → 不要重试,充值后再试
- 创建任务:可以高并发(10-30个)
- 查询状态:建议并发数 ≤ 10
- 下载视频:建议并发数 ≤ 5
定价说明
异步 API 与同步 API 价格完全相同,按次计费。
计费规则:
- ✓ 仅在视频成功生成时收费(status = “completed”)
- ✗ 失败、超时、取消不计费
- ✗ 内容安全问题失败也不扣费(与同步API的重要区别⭐)
- ✗ 查询状态不计费
常见问题
任务的有效期是多久? 任务有效期:24 小时- 创建任务后,24 小时内可随时查询任务状态
- 视频生成完成后,文件保存 24 小时
- 超过 24 小时后,任务和视频将被自动清理
- 视频生成完成后立即下载
- 不要依赖服务器长期存储
- video_id 错误 - 检查是否复制完整
- 任务已过期 - 超过 24 小时
- 网络问题 - 重试请求
- 不同的端点
- 不同的调用方式
- 相同的定价
- 共享同一个 API Key 和余额
- 快速测试 → 使用同步 API
- 生产环境 → 使用异步 API(更稳定)
- 批量生成 → 使用异步 API
错误处理
常见错误码
错误响应格式
技术支持
需要帮助?
如有问题,欢迎联系我们:- 邮箱: threezhang.cn@gmail.com
- 微信: Kikivivikids
- Telegram: https://t.me/laozhang_cn
- 文档: