核心功能
RawUGC Video Generation API 是面向开发者的专业 AI 视频生成服务接口，整合了 OpenAI Sora 2、快手可灵 2.6（含运动控制）、Google Veo3 等主流视频生成模型，提供标准化的 RESTful API 调用方式。
核心用法
1. 视频生成（POST /videos/generate）
- 文生视频：通过
prompt字段描述场景，支持 1-5000 字符 - 图生视频：通过
imageUrls传入图片，Sora 2 最多支持 10 张图 - 视频驱动：Kling 2.6 支持
videoUrls实现运动控制生成 - 可选参数：画幅比例（portrait/landscape）、分辨率（720p/1080p）、帧数（10/15 帧）、角色绑定
2. 任务状态查询（GET /videos/:taskId）
- 实时轮询任务进度（
pending→processing→completed/failed） - 返回字段包含：进度百分比、预计完成时间、实际耗时、失败原因代码
3. 视频列表管理（GET /videos）
- 支持按状态筛选、分页查询
- 默认返回 50 条，最大支持 100 条/页
显著优点
- 模型集成度高：一站式接入 Sora 2、Kling、Veo3 等顶级模型，无需分别对接
- 商业级稳定性：提供任务队列、进度追踪、失败重试机制
- 灵活的工作流：支持角色一致性（
selectedCharacter）、分辨率选择、画幅适配 - 标准化错误处理：采用 RFC 7807 Problem Details 规范，错误码语义清晰
潜在局限
- 异步轮询模式：必须自行实现轮询逻辑获取结果，非即时返回
- 付费门槛：按 credits 计费，余额不足时返回 402 错误
- 无原生流式输出：需等待完整生成后才能获取视频 URL
- 平台依赖：需 RawUGC 账号体系，无法脱离其生态独立运行
典型风险
- API Key 泄露风险：密钥需通过环境变量
RAWUGC_API_KEY注入，硬编码或日志打印会导致未授权访问 - 成本失控：视频生成消耗 credits 较高，高频调用可能导致账户透支
- 内容合规：AI 生成视频需遵守平台内容政策，违规生成可能导致任务失败或账号受限
- 轮询频率不当：过于频繁的轮询（<10秒）可能触发 429 限流
适合人群
- 需将 AI 视频能力集成到产品中的开发者/技术团队
- 已有 RawUGC 账户、熟悉 REST API 调试的创作者
- 追求多模型灵活切换、不愿维护多平台对接成本的企业