SuperAPI AI 工具集

rawugc-video-api

编程与开发

查看项目

更新于 10-16 06:42

技能介绍

用途:为智能体提供调用 RawUGC 视频生成 API 的过程性知识,用于创建和管理 AI 视频,支持 sora-2-text-to-video、sora-2-image-to-video、kling-2.6/motion-control、veo3、veo3_fast 等模型。

鉴权:从环境变量 RAWUGC_API_KEY 读取密钥,密钥在 RawUGC 控制台创建,须保密,不得硬编码或写入日志。每个请求携带请求头 Authorization: Bearer <RAWUGC_API_KEY 的值>。若变量缺失或为空,应提示用户设置并从控制台获取密钥。

基础地址:生产环境为 https://rawugc.com/api/v1,以下路径均相对该地址。

主要接口:POST /videos/generate 发起生成,请求体为 JSON,字段包括 model(必填)、prompt(文生视频与 veo3 必填,1–5000 字符)、imageUrls(图生视频与 kling 使用,最多 10 个)、videoUrls(仅 kling-2.6/motion-control 必填,最多 1 个)、aspectRatio、nFrames("10" 或 "15")、selectedCharacter、characterOrientation、mode(720p 或 1080p)。成功返回 201,含 taskId、model、status、creditsUsed、newBalance、estimatedCompletionTime、createdAt。GET /videos/:taskId 查询任务状态,返回 status(pending | processing | completed | failed)、resultUrl(completed 时)、failCode、failMessage、progress 等。GET /videos 列出用户视频,支持 status、limit(1–100,默认 50)、page(默认 1)过滤与分页。

错误处理:响应采用 RFC 7807 Problem Details(type、title、status、detail、可选 instance 与 errors)。400 为校验错误,需向用户展示 detail 与 errors;401 为鉴权错误,提示检查 RAWUGC_API_KEY;402 为积分不足,需在控制台充值;404 为视频不存在;429 为超出速率限制,按响应指示时间重试或退避;500 为内部错误,建议重试或联系支持。

工作流:先生成再轮询。调用 POST /videos/generate,记录返回的 taskId;随后周期性调用 GET /videos/:taskId(例如每 10–30 秒,可选指数退避);status 为 completed 时使用 resultUrl,为 failed 时向用户展示 failCode 与 failMessage。

限制:需有效 API 密钥与足够积分;各模型对 prompt、imageUrls、videoUrls 的必填与数量限制不同;速率受限时需退避重试。更完整的请求/响应结构与状态码见 reference.md。