Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Call the RawUGC Video Generation API to create and manage AI videos (Sora 2 and other models). Use when the user wants to generate AI videos via RawUGC, inte...
Call the RawUGC Video Generation API to create and manage AI videos (Sora 2 and other models). Use when the user wants to generate AI videos via RawUGC, inte...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Procedural knowledge for agents to call the RawUGC API. All requests require an API key from the RawUGC dashboard, passed via environment variable.
Environment variable: Read the API key from RAWUGC_API_KEY. The key is created in the RawUGC dashboard and must be kept secret; do not hardcode or log it. Header: Send on every request: Authorization: Bearer <value of RAWUGC_API_KEY>. If RAWUGC_API_KEY is missing or empty, inform the user they must set it and obtain a key from the RawUGC dashboard.
Production: https://rawugc.com/api/v1 All paths below are relative to this base.
RawUGC uses date-based API versioning. The current latest version is 2026-03-06. RawUGC-Version request header: Override the version per-request (recommended). API key pinned version: Set when creating the key in the dashboard. Fallback: Latest version (2026-03-06) if neither is set. Always send RawUGC-Version: 2026-03-06 in requests to ensure consistent behavior.
Initiate video generation. Request body (JSON): FieldTypeRequiredDescriptionmodelstringYessora-2-text-to-video, sora-2-image-to-video, kling-2.6/motion-control, veo3, veo3_fastpromptstringFor text-to-video / veo3Text description (1-5000 chars)imageUrlsstring[]For image-to-video / klingURLs, max 10. Veo3/veo3_fast accept up to 2 optional images.videoUrlsstring[]For klingURLs, max 1. Required for kling-2.6/motion-controlaspectRatiostringNoSora: portrait/landscape. Veo3: 16:9/9:16/AutonFramesstringNo"10" or "15" (Sora only)selectedCharacterstringNoCharacter username (e.g. rawugc.mia)characterOrientationstringNoimage or video (kling only)modestringNo720p or 1080p (kling only) Response (201): videoId, model, status, creditsUsed, newBalance, estimatedCompletionTime, createdAt.
Get video status. Returns videoId, status, model, prompt, creditsUsed, url (when completed), createdAt, completedAt, failCode, failMessage, versions (edit history array).
List videos. Query: status, limit (1-100, default 50), page. Returns videos array + pagination.
Add styled captions to a completed video. Costs 1 credit. FieldTypeRequiredDescriptionvideoIdstringYesVideo identifier (vid_xxx)languagestringNoLanguage code (e.g. en). Defaults to auto-detect Response (200): videoId, url, version, operation, creditsUsed.
Add text overlay to a completed video. FieldTypeRequiredDescriptionvideoIdstringYesVideo identifier (vid_xxx)textstringYesOverlay text (1-500 chars)positionstringNotop, center, or bottomfontSizeintegerNo8-200 pixelstopBottomMarginintegerNo0-500 pixelsstrokeThicknessnumberNo0-10 Response (200): videoId, url, version, operation, creditsUsed.
Generate AI images using Nano Banana models. Async -- poll GET /images/:imageId. FieldTypeRequiredDescriptionmodelstringYesnano-banana-2 (text-to-image, 4 credits) or google/nano-banana-edit (image editing, 2 credits)promptstringYesText description or edit instruction (1-20000 chars)imageUrlsstring[]For editingSource images. Required for google/nano-banana-edit. Optional for nano-banana-2 (reference images, max 14).aspectRatiostringNoFor nano-banana-2: 1:1, 16:9, 9:16, auto, etc.imageSizestringNoFor google/nano-banana-edit: 1:1, 16:9, 9:16, auto, etc.resolutionstringNoFor nano-banana-2: 1K, 2K, 4KoutputFormatstringNopng, jpeg, jpggoogleSearchbooleanNoUse Google Web Search grounding (nano-banana-2 only) Response (201): imageId, model, status, creditsUsed, newBalance, estimatedCompletionTime, createdAt.
Get image status. Returns imageId, status, model, prompt, url (when completed), imageSize, resolution, outputFormat, creditsUsed, createdAt, completedAt, failCode, failMessage.
List images. Query: status, limit (1-100, default 20), page. Returns images array + pagination.
Generate AI music using Suno models. 3 credits per generation. Async -- poll GET /music/:musicId. FieldTypeRequiredDescriptionpromptstringYesMusic description (1-2000 chars)modelstringNoV3_5, V4, V4_5, V4_5PLUS, V4_5ALL, V5 (default: V5)instrumentalbooleanNoInstrumental only, no vocals (default: true)titlestringNoTrack title (max 200 chars). Enables custom mode with style.stylestringNoStyle descriptor (max 500 chars, e.g. lo-fi hip hop) Response (201): musicId, model, status, creditsUsed, newBalance, estimatedCompletionTime, createdAt.
Get music status. Returns musicId, status, model, prompt, audioUrl (when completed), albumArtUrl, duration, title, creditsUsed, createdAt, completedAt, failCode, failMessage.
List music tracks. Query: status, limit (1-100, default 20), page. Returns tracks array + pagination.
Upload a video or image file. Returns a URL for use in generation requests (imageUrls, videoUrls) or analyze-video. Max 100MB. Request: multipart/form-data with file field. Accepted types: video/mp4, video/quicktime, video/webm, image/png, image/jpeg, image/webp. Response (200): url, contentType, size.
List all available AI characters (built-in + custom). Returns characters array, count, adminCount, userCount.
Get a character by ID. Returns _id, username, displayName, description, videoPreviewUrl, type (admin/user), isActive, createdAt, updatedAt.
Personas define target audiences for content plan generation. GET /personas -- List all. Returns personas array + count. POST /personas -- Create. Body: name (required, max 200), description (required, max 5000). Returns id. GET /personas/:personaId -- Get one. PATCH /personas/:personaId -- Update. Body: name, description (both optional). DELETE /personas/:personaId -- Delete. PersonaResponse: _id, organizationId, name, description, createdAt, updatedAt.
Brand/positioning messaging templates. GET /messaging -- List all. Returns messages array + count. POST /messaging -- Create. Body: name (required, max 200), body (required, max 5000). Returns id. GET /messaging/:messageId -- Get one. PATCH /messaging/:messageId -- Update. Body: name, body (both optional). DELETE /messaging/:messageId -- Delete. MessagingResponse: _id, organizationId, name, body, createdAt, updatedAt.
Products for video generation. GET /products -- List all. Returns products array + count. POST /products -- Create. Body: name (required, max 200), photos (required, URL array), description (max 1000), messaging (max 5000). Returns id. GET /products/:productId -- Get one. PATCH /products/:productId -- Update. Body: name, description, photos, messaging (all optional). DELETE /products/:productId -- Delete. ProductResponse: _id, name, description, photos, messaging, createdAt, updatedAt.
Video/image creative styles with optional prompt templates. GET /styles -- List all (built-in + custom). Query: type (video/image). Returns styles array + count. POST /styles -- Create. Body: name (required, max 200), description (max 1000), type (video/image), aspectRatio (portrait/landscape/square), promptTemplate (max 5000, supports {productName}, {messaging}, {character} placeholders). Returns id. GET /styles/:styleId -- Get one. PATCH /styles/:styleId -- Update. All fields optional. DELETE /styles/:styleId -- Delete. StyleResponse: _id, name, description, type, aspectRatio, styleId, promptTemplate, isAdmin, isStandard.
List connected social accounts (max 3 per org). Returns accounts array + count. Each account: accountId, platform (tiktok/instagram/youtube), username, displayName, profilePicture, isActive.
Sync connected accounts from the scheduling provider. Returns { success: boolean }.
Disconnect a social account. Returns { success: boolean }.
Schedule, draft, or immediately publish a video to social media. FieldTypeRequiredDescriptionvideoUrlstringYesURL of video to postaccountIdsstring[]YesTarget account IDsmodestringYesschedule, draft, or nowscheduledForintegerFor scheduleUnix timestamp (ms)timezonestringNoIANA timezone (default: UTC)contentstringNoCaption (max 2200 chars)videoIdstringNoRawUGC video ID to linkpublishToInboxbooleanNoSend to TikTok Creator InboxtiktokPrivacyLevelstringNoSELF_ONLY, PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATORtiktokAllowCommentbooleanNoAllow TikTok commentstiktokAllowDuetbooleanNoAllow TikTok duetstiktokAllowStitchbooleanNoAllow TikTok stitchestiktokCommercialContentTypestringNonone, brand_organic, brand_content Response (201): SocialPost object.
List posts. Query: fromDate (ms), toDate (ms), includeDrafts (boolean). Returns posts array + count.
Get a post.
Update a post. Body: content, scheduledFor, timezone, accountIds (at least one field required).
Delete a post. Returns { success: boolean }.
Reschedule a post. Body: scheduledFor (required, ms), timezone.
Immediately publish a draft post. SocialPost: postId, platforms, status (draft/scheduled/published/failed), scheduledFor, timezone, content, videoUrl, createdAt, publishedAt.
Get a viral library video with full AI analysis (hooks, keyframes, performance insights). Returns ViralLibraryVideo.
Semantic search across analyzed videos. Query: q (required, natural language), limit (1-50, default 20). Returns results (array of { video, score }), query, total.
Scrape TikTok videos. Costs 3 credits. FieldTypeRequiredDescriptionquerystringYesSearch keyword, hashtag, or query (max 500)modestringNokeyword, hashtag, search (default: keyword)limitintegerNo1-10 (default: 10) Response (200): scrapeId (use with content-plans), count, videos (array with id, url, author, description, stats, duration, hashtags, thumbnail, videoUrl).
Generate a content plan from scraped videos. Costs 3 credits. FieldTypeRequiredDescriptionscrapeIdstringYesFrom scrape-tiktok responsebriefstringYesContent plan goals (max 5000) Response (200): planId, scrapeId, brief, topWins, gapsToTest, blueprints (array with category, strategy, evidence, contentIdeas).
List all content plans. Returns plans array + count.
Analyze any video URL (social links or direct URLs). Costs 1 credit. Max 150MB. FieldTypeRequiredDescriptionvideoUrlstringYesVideo URL to analyzepromptstringNoCustom analysis prompt (max 5000) Response (200): summary, hook, keyframes (array with timestamp, type, description, visual, audio, text), durationSeconds, tags, whyItPerformed, attributesToCopy, hooksToTest.
All error responses use RFC 7807 Problem Details (JSON): type, title, status, detail, instance, errors. StatusMeaning400Validation error. Surface detail and errors to user.401Auth error. Check RAWUGC_API_KEY.402Insufficient credits. Add credits in dashboard.403Insufficient scope. API key lacks permissions.404Resource not found.429Rate limit exceeded. Check X-RateLimit-Reset header.500Server error. Retry or contact support.
API Key: 10 req/min. Session: 20 req/min. Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (unix timestamp).
Generate: POST to the generation endpoint. Note the returned ID (videoId/imageId/musicId). Poll: GET the status endpoint periodically (10-30s). Use exponential backoff. Finish: When status === 'completed', use the result URL. When failed, surface error to user. Edit (video only): POST to /videos/captions or /videos/overlay. For full request/response shapes, see reference.md.
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.