API 文档

欢迎使用 Veo3api.ai API 文档。本指南将帮助您了解如何有效地使用我们的 API 服务。

API 服务概览

我们目前提供以下 API 服务：

Veo3 - 由 Veo3 模型提供的高级 AI 视频生成能力
- 高质量文本到视频生成
- 高质量图片到视频生成
- 异步处理与回调通知
账户管理 - 监控和管理您的账户信息、积分余额、使用配额和 API 访问设置
- 积分余额查询
- 使用记录跟踪
- API 访问管理

基础信息

API 服务器: https://api.veo3api.ai
API 版本: 1.0.0
技术支持: [email protected]

认证

所有 API 都需要使用 Bearer Token 认证：

Authorization: Bearer YOUR_API_KEY

获取您的 API Key：

访问 API Key 管理页面
生成您的专属 API Key
在所有 API 请求中使用它

重要提示：

妥善保管您的 API Key
切勿与他人分享您的 API Key
如果怀疑泄露，请立即重置

API 服务

Veo3 视频生成

Flux Kontext API 提供高级 AI 图像生成和编辑能力：

通过 /api/v1/veo/generate 创建视频
支持文本生成视频以及图片生成视频
通过 /api/v1/veo/record-info 查询生成任务详情

主要特点：

高质量输出，专业级效果
灵活的视频生成能力

了解更多关于 Veo3 API →

账户管理

通过账户管理系统监控和管理您的 API 使用：

通过 /api/v1/common/credit 查看剩余积分
跟踪使用记录
设置使用提醒

了解更多关于账户管理 →

错误处理

我们的 API 使用标准的 HTTP 状态码和详细的错误信息：

状态码	说明
200	成功 - 请求已成功处理
401	未授权 - 认证凭证缺失或无效
402	积分不足 - 账户没有足够的积分执行操作
404	未找到 - 请求的资源或端点不存在
422	验证错误 - 请求参数未通过验证检查
429	请求限制 - 此资源的请求限制已超出
455	服务不可用 - 系统当前正在维护
500	服务器错误 - 处理请求时发生意外错误
505	功能已禁用 - 请求的功能当前已禁用

最佳实践

认证
- 安全存储您的 API Key
- 定期轮换密钥以增强安全性
- 为认证失败实现适当的错误处理
Veo3 视频生成
- 处理图像上传大小限制(最大 10MB)和格式限制
- 为并发任务限制实现适当的错误处理
- 通过回调或 record-info 接口监控任务状态
账户管理
- 定期监控积分使用情况
- 为积分耗尽实现备用机制
- 在适当情况下考虑缓存响应

需要帮助？

如果您遇到任何问题或有疑问，请通过以下方式联系我们：

📧 邮箱: [email protected]
💬 在线支持: 控制台
📚 API 参考: 完整文档

语言支持

本文档提供中英文两种语言版本。您可以使用导航栏中的语言选择器切换语言。

API 服务概览​

基础信息​

认证​

API 服务​

Veo3 视频生成​

账户管理​

错误处理​

最佳实践​

需要帮助？​