# RawUGC

> AI Video Generation API Documentation

## Docs

- [Get character](https://docs.rawugc.com/api-reference/characters/get-character.md): Get a specific character by ID. Only returns characters you have access to (admin characters or your own).
- [List characters](https://docs.rawugc.com/api-reference/characters/list-characters.md): List all available AI characters (built-in admin characters + user's own custom characters).
- [Generate image](https://docs.rawugc.com/api-reference/image-generation/generate-image.md): Generate AI images using Nano Banana models. Supports text-to-image generation with nano-banana-2 (4 credits) and image-to-image editing with google/nano-banana-edit (2 credits).
- [Get image](https://docs.rawugc.com/api-reference/image-generation/get-image.md): Get an image by ID. Returns full details including status, model, URL (when completed), and generation parameters.
- [List images](https://docs.rawugc.com/api-reference/image-generation/list-images.md): List your image generation tasks with pagination. Returns tasks in reverse chronological order.
- [Create messaging](https://docs.rawugc.com/api-reference/messaging/create-messaging.md): Create a new brand/positioning message.
- [Delete messaging](https://docs.rawugc.com/api-reference/messaging/delete-messaging.md)
- [Get messaging](https://docs.rawugc.com/api-reference/messaging/get-messaging.md)
- [List messaging](https://docs.rawugc.com/api-reference/messaging/list-messaging.md): List all brand/positioning messaging for the authenticated user's organization.
- [Update messaging](https://docs.rawugc.com/api-reference/messaging/update-messaging.md)
- [Generate music](https://docs.rawugc.com/api-reference/music-generation/generate-music.md): Generate AI music using Suno models via the RawUGC platform. Supports instrumental and vocal tracks with customizable genre, mood, and style. Each generation costs 3 credits.
- [Get music track](https://docs.rawugc.com/api-reference/music-generation/get-music-track.md): Get a music track by ID. Returns full details including status, model, audio URL, album art, and duration when completed.
- [List music tracks](https://docs.rawugc.com/api-reference/music-generation/list-music-tracks.md): List all music generation tasks for the authenticated user. Supports filtering by status and pagination.
- [Create persona](https://docs.rawugc.com/api-reference/personas/create-persona.md): Create a new persona for content plan generation.
- [Delete persona](https://docs.rawugc.com/api-reference/personas/delete-persona.md): Delete a persona.
- [Get persona](https://docs.rawugc.com/api-reference/personas/get-persona.md): Get a specific persona by ID.
- [List personas](https://docs.rawugc.com/api-reference/personas/list-personas.md): List all personas for the authenticated user's organization.
- [Update persona](https://docs.rawugc.com/api-reference/personas/update-persona.md): Update an existing persona.
- [Create product](https://docs.rawugc.com/api-reference/products/create-product.md): Create a new product for video generation.
- [Delete product](https://docs.rawugc.com/api-reference/products/delete-product.md)
- [Get product](https://docs.rawugc.com/api-reference/products/get-product.md)
- [List products](https://docs.rawugc.com/api-reference/products/list-products.md): List all products for the authenticated user's organization.
- [Update product](https://docs.rawugc.com/api-reference/products/update-product.md)
- [Analyze a video](https://docs.rawugc.com/api-reference/research/analyze-a-video.md): Analyze any video URL — social links (TikTok, Instagram, YouTube) or direct video URLs. Social links are downloaded automatically. Returns rich analysis including hooks, keyframes, and performance insights. Maximum file size: 150MB (~5 minutes). Costs 1 credit.
- [Create a content plan](https://docs.rawugc.com/api-reference/research/create-a-content-plan.md): Generate a content plan from scraped TikTok videos. Requires a scrapeId from the scrape-tiktok endpoint. Costs 3 credits.
- [List content plans](https://docs.rawugc.com/api-reference/research/list-content-plans.md): List all content plans you've created.
- [Scrape TikTok videos](https://docs.rawugc.com/api-reference/research/scrape-tiktok-videos.md): Scrape TikTok videos by keyword, hashtag, or search query. Returns video metadata and temporary download URLs. Costs 3 credits per request.
- [Disconnect an account](https://docs.rawugc.com/api-reference/social-accounts/disconnect-an-account.md): Disconnect a social media account from your organization.
- [List connected accounts](https://docs.rawugc.com/api-reference/social-accounts/list-connected-accounts.md): List all social media accounts connected to your organization. Supports up to 3 accounts per organization.
- [Sync accounts](https://docs.rawugc.com/api-reference/social-accounts/sync-accounts.md): Sync connected social media accounts from the scheduling provider. Use this after connecting a new account in the dashboard.
- [Delete a post](https://docs.rawugc.com/api-reference/social-scheduling/delete-a-post.md): Delete a scheduled or draft post.
- [Get a post](https://docs.rawugc.com/api-reference/social-scheduling/get-a-post.md): Retrieve details for a specific scheduled or draft post.
- [List scheduled posts](https://docs.rawugc.com/api-reference/social-scheduling/list-scheduled-posts.md): Retrieve a list of scheduled and draft social media posts. Optionally filter by date range or include drafts.
- [Publish a draft](https://docs.rawugc.com/api-reference/social-scheduling/publish-a-draft.md): Immediately publish a draft post to the configured social media platforms.
- [Reschedule a post](https://docs.rawugc.com/api-reference/social-scheduling/reschedule-a-post.md): Change the scheduled publish time of an existing post.
- [Schedule or draft a post](https://docs.rawugc.com/api-reference/social-scheduling/schedule-or-draft-a-post.md): Schedule a video for publishing to social media platforms, or save it as a draft. Supports TikTok, Instagram, and YouTube. TikTok posts support additional privacy and content settings.
- [Update a post](https://docs.rawugc.com/api-reference/social-scheduling/update-a-post.md): Update the caption, target platforms, or scheduled time of an existing post. At least one field must be provided.
- [Create custom style](https://docs.rawugc.com/api-reference/styles/create-custom-style.md): Create a new custom video creative style with an optional prompt template.
- [Delete custom style](https://docs.rawugc.com/api-reference/styles/delete-custom-style.md)
- [Get custom style](https://docs.rawugc.com/api-reference/styles/get-custom-style.md)
- [List styles](https://docs.rawugc.com/api-reference/styles/list-styles.md): List all available video creative styles (built-in admin styles + user's custom styles).
- [Update custom style](https://docs.rawugc.com/api-reference/styles/update-custom-style.md)
- [Upload a file](https://docs.rawugc.com/api-reference/upload/upload-a-file.md): Upload a video or image file. Returns a URL that can be used in generation requests (e.g. imageUrls for image-to-video, videoUrls for motion control) or passed to the analyze-video endpoint. Maximum file size: 100MB.
- [Add captions](https://docs.rawugc.com/api-reference/video-editing/add-captions.md): Add styled captions to a video. The video is processed and a download URL for the captioned video is returned. Costs 1 credit.
- [Add text overlay](https://docs.rawugc.com/api-reference/video-editing/add-text-overlay.md): Add a text overlay to a video. The video is processed with FFmpeg and a public URL for the result is returned.
- [Generate a video](https://docs.rawugc.com/api-reference/video-generation/generate-a-video.md): Initiate video generation using a specified AI model. Different models require different parameters — see the model descriptions for details.
- [Get video](https://docs.rawugc.com/api-reference/video-generation/get-video.md): Get a video by ID. Returns full details including status, model, URL (when completed), and a `versions` array with edit history when available.
- [List videos](https://docs.rawugc.com/api-reference/video-generation/list-videos.md): List all videos with optional filtering and pagination
- [Get viral library video](https://docs.rawugc.com/api-reference/viral-library/get-viral-library-video.md): Get a single video from the viral library with its full AI analysis, including per-second keyframes, hooks, performance insights, and actionable attributes.
- [Search viral library](https://docs.rawugc.com/api-reference/viral-library/search-viral-library.md): Semantic search across all analyzed videos using natural language queries. Search by hooks, content themes, performance traits, or any aspect of the video analysis. Powered by vector embeddings for intelligent matching.
- [Authentication](https://docs.rawugc.com/authentication.md): Authenticate with the RawUGC API using Bearer tokens
- [API Changelog](https://docs.rawugc.com/changelog.md): Version-by-version list of API changes and migration guides
- [Claude Code](https://docs.rawugc.com/claude-code.md): Generate AI videos directly from your terminal using the RawUGC skill for Claude Code
- [Error Handling](https://docs.rawugc.com/errors.md): Understanding API error responses
- [Introduction](https://docs.rawugc.com/introduction.md): Generate AI videos and research TikTok content with the RawUGC API
- [Models](https://docs.rawugc.com/models.md): Available AI models for video generation
- [Open Claw](https://docs.rawugc.com/open-claw.md): The recommended way to use the RawUGC API through the official Open Claw skill
- [Quickstart](https://docs.rawugc.com/quickstart.md): Generate your first AI video in 3 steps
- [Rate Limits](https://docs.rawugc.com/rate-limits.md): API rate limiting and throttling
- [Code Examples](https://docs.rawugc.com/sdks.md): API usage examples in multiple languages
- [API Versioning](https://docs.rawugc.com/versioning.md): How RawUGC uses date-based API versioning to evolve the API without breaking your integration

## OpenAPI Specs

- [openapi](https://docs.rawugc.com/openapi.json)