核心用法
RawUGC Video Generation API 是面向开发者和 AI Agent 的视频生成服务接口，支持多种前沿 AI 视频模型：
- Sora 2（OpenAI）：文本生成视频、图像生成视频
- Veo 3 / Veo 3 Fast（Google）：快速文本到视频生成
- Kling 2.6 Motion Control：支持图像+视频输入的运动控制生成
主要功能包括：
1. 创建视频：通过 POST /videos/generate 提交生成任务，支持自定义模型、提示词、宽高比、分辨率、帧数等参数
2. 状态查询：通过 GET /videos/:taskId 轮询任务进度，获取完成后的视频 URL
3. 视频列表：通过 GET /videos 分页查询历史生成记录
典型工作流为：提交生成请求 → 获取 taskId → 定期轮询状态（建议 10-30 秒间隔）→ 获取结果 URL。
显著优点
- 多模型集成：一个 API 对接多个顶级视频生成模型，无需分别接入
- 统一接口规范：标准化的 RESTful API，RFC 7807 错误详情格式，便于集成和调试
- 灵活参数控制：支持角色一致性（selectedCharacter）、分辨率选择（720p/1080p）、多种宽高比
- 实时状态追踪：详细的任务状态机和进度百分比，便于构建可靠的异步工作流
- 按量计费透明：每次请求返回 creditsUsed 和 newBalance，成本可控
潜在缺点与局限性
- 第三方依赖：服务完全依赖 RawUGC 平台可用性，存在单点故障风险
- 异步轮询开销：必须实现轮询逻辑，增加客户端复杂度和延迟
- 成本累积风险：视频生成消耗积分，高频或大参数请求可能导致快速扣费
- 内容审核不可控：未明确说明平台层面的内容安全策略，生成内容可能因未知原因失败
- 速率限制：429 错误需处理退避逻辑，高并发场景需额外设计
适合人群
- AI 应用开发者需快速集成视频生成功能
- 自动化内容创作 Agent 和 Workflow 工具
- 营销、广告、社交媒体领域的批量视频生成需求
- 原型验证和 MVP 开发，追求快速上线而非自建基础设施
常规风险
| 风险类别 | 说明 |
|---------|------|
| **密钥泄露** | API Key 通过环境变量注入，需确保 CI/CD、日志系统不泄露 |
| **积分透支** | 402 错误提示余额不足，需在调用前监控 credits 或设置预算告警 |
| **任务悬挂** | 网络中断可能导致轮询停止，需设置任务超时和清理机制 |
| **内容合规** | AI 生成视频可能涉及版权、肖像权、虚假信息等问题，需用户自行承担合规责任 |
| **服务终止** | RawUGC 作为商业平台，存在定价变更、服务下线、API 变更等商业风险 |