# Unsora

- [Get started](https://tryunsora.com/docs/get-started.md): Create an Unsora API key and make your first API call — generate video, images, music, or voiceovers in a few minutes.
- [API guide](https://tryunsora.com/docs/api-guide.md): How to authenticate with the Unsora API — API keys, rate limits, idempotency keys, credits, and polling async generation jobs.
- [Introduction](https://tryunsora.com/docs/api-reference/introduction.md): Overview of the Unsora public API — generate video, images, music, and voiceovers, clip long videos, and schedule social posts over REST.
- [CLI quickstart](https://tryunsora.com/docs/cli/quickstart.md): Install the Unsora CLI, authenticate with your API key, and run your first AI generation from the terminal in under five minutes.
- [Generate media](https://tryunsora.com/docs/cli/generate.md): Create images, video, music, voiceovers, thumbnails, and clips from the terminal with the Unsora CLI — one command per generation type.
- [Upload media](https://tryunsora.com/docs/cli/uploads.md): Upload your own files into your Unsora media library from the CLI so they're ready to use in posts, clips, and generations.
- [Social posting](https://tryunsora.com/docs/cli/social-posting.md): Schedule and publish posts to YouTube, TikTok, Instagram, Facebook, and more straight from the terminal with the Unsora CLI.
- [Credits balance](https://tryunsora.com/docs/api-reference/user/credits.md): Get the authenticated user's current credit balance, including subscription credits, top-ups, and how credits are consumed by each tool.
- [Subscription](https://tryunsora.com/docs/api-reference/user/subscription.md): Get the authenticated user's billing plan and Stripe subscription state, including current plan, credits per month, and renewal status.
- [Get accounts](https://tryunsora.com/docs/api-reference/accounts/get_accounts.md): List every social account connected to your Unsora workspace for scheduling — YouTube, TikTok, Instagram, Facebook, LinkedIn, Bluesky, and more.
- [Create Post](https://tryunsora.com/docs/api-reference/posts/create_post.md): Schedule or publish posts to YouTube, TikTok, Instagram, Facebook, LinkedIn, Bluesky, Threads, and Pinterest.
- [List Posts](https://tryunsora.com/docs/api-reference/posts/list_posts.md): Paginated list of your scheduled, published, and failed posts across YouTube, TikTok, Instagram, Facebook, LinkedIn, Bluesky, and more.
- [Get post](https://tryunsora.com/docs/api-reference/posts/get_post.md): Fetch a single post by ID, including its schedule time, target platforms, media attachments, captions, and per-platform publish status.
- [Update post](https://tryunsora.com/docs/api-reference/posts/update_post.md): Update a scheduled post's caption, media, platforms, or schedule time before it publishes. Returns the updated post object.
- [Publish post](https://tryunsora.com/docs/api-reference/posts/publish.md): Publish a post to its connected social platforms and return per-platform results, including platform post IDs and any errors.
- [Retry post](https://tryunsora.com/docs/api-reference/posts/retry.md): Retry a failed post. Re-attempts publishing to any platform that errored and returns the updated per-platform publish status.
- [Delete post](https://tryunsora.com/docs/api-reference/posts/delete_post.md): Delete a scheduled or draft post from the Unsora scheduler. Already-published content is not removed from the social platforms.
- [Poll generation status](https://tryunsora.com/docs/api-reference/image/poll-status.md): Check the status of image, AI influencer, and thumbnail generation jobs — returns the latest state and finished assets when complete.
- [Poll video status](https://tryunsora.com/docs/api-reference/video/poll-status.md): Poll a video generation job until it completes — returns the latest status and the finished video URL once rendering is done.
- [Poll music status](https://tryunsora.com/docs/api-reference/music/poll-status.md): Poll a music generation job — returns the latest status and finished audio tracks with stream and download URLs when complete.
- [Poll voiceover status](https://tryunsora.com/docs/api-reference/voiceovers/poll-status.md): Poll a voiceover generation job — returns the latest status and the finished audio file with a download URL when complete.
- [Poll clipping status](https://tryunsora.com/docs/api-reference/clippings/poll-status.md): Poll an AI clipping job — syncs with the provider and returns the latest state plus finished clips as soon as they are exported.
- [Create video](https://tryunsora.com/docs/api-reference/video/create.md): Queue a video generation job with Sora 2, Veo 3, Kling, and other supported models, then poll until the finished video is ready.
- [List video generations](https://tryunsora.com/docs/api-reference/video/list.md): Paginated list of video generation jobs for the authenticated user, including model, prompt, status, and finished video assets.
- [Delete video generation](https://tryunsora.com/docs/api-reference/video/delete.md): Permanently delete a video generation job and its output video from your Unsora account. This action cannot be undone.
- [Create image](https://tryunsora.com/docs/api-reference/image-generations/create.md): Queue an AI image generation job from a text prompt with models like GPT Image and Seedream, then poll until your images are ready.
- [List generations](https://tryunsora.com/docs/api-reference/image-generations/list.md): Paginated list of image generation jobs for the authenticated user, including prompts, models, statuses, and output assets.
- [Get image generation](https://tryunsora.com/docs/api-reference/image-generations/get.md): Fetch one image generation job by ID, including its status, prompt, model, and finished image assets ready for download.
- [Delete generation](https://tryunsora.com/docs/api-reference/image-generations/delete.md): Permanently delete an image generation job and its output assets from your Unsora account. This action cannot be undone.
- [Create song](https://tryunsora.com/docs/api-reference/music-generations/create.md): Queue a Mureka AI music generation job from lyrics and a style prompt, then poll until your finished tracks are ready to stream or download.
- [List generations](https://tryunsora.com/docs/api-reference/music-generations/list.md): Paginated list of music generations for the authenticated user, including status, lyrics, style prompts, and finished tracks.
- [Get generation](https://tryunsora.com/docs/api-reference/music-generations/get.md): Fetch a single music generation by ID, including status, lyrics, style prompt, and finished audio tracks with stream and download URLs.
- [Delete generation](https://tryunsora.com/docs/api-reference/music-generations/delete.md): Permanently delete a music generation record and its generated tracks from your Unsora account. This action cannot be undone.
- [Music generator](https://tryunsora.com/docs/guides/music-generator/overview.md): Generate complete songs from lyrics and style prompts in the Unsora dashboard — pick a model, write lyrics, and get streamable tracks.
- [Playback & player](https://tryunsora.com/docs/guides/music-generator/playback.md): Listen to generated songs while you work — global audio player, synced lyrics view, and a responsive layout across the dashboard.
- [List voices](https://tryunsora.com/docs/api-reference/voiceovers/voices.md): Browse the 20 ElevenLabs Eleven v3 voices available for Unsora voiceovers, each with a preview clip to help you pick the right one.
- [Create voiceover](https://tryunsora.com/docs/api-reference/voiceovers/create.md): Turn a script into natural speech with ElevenLabs Eleven v3 — pick from 20 voices and poll until the finished audio is ready.
- [List voiceovers](https://tryunsora.com/docs/api-reference/voiceovers/list.md): Paginated history of voiceover jobs for the authenticated user, including script, voice, status, and finished audio files.
- [Delete voiceover](https://tryunsora.com/docs/api-reference/voiceovers/delete.md): Permanently delete a voiceover job and its generated audio file from your Unsora account. This action cannot be undone.
- [Create influencer](https://tryunsora.com/docs/api-reference/influencer-studio/create.md): Queue one or more AI influencer portrait jobs to generate consistent, on-brand photos of your virtual creator from a reference image.
- [Get influencers](https://tryunsora.com/docs/api-reference/influencer-studio/list.md): Paginated list of AI influencer portrait jobs for the authenticated user, including status, prompts, and generated image assets.
- [Delete influencer](https://tryunsora.com/docs/api-reference/influencer-studio/delete.md): Permanently delete an AI influencer portrait job and its generated images from your Unsora account. This action cannot be undone.
- [Create thumbnail](https://tryunsora.com/docs/api-reference/thumbnails/create.md): Generate click-worthy YouTube thumbnails from a title, script, or reference image — returns a job you can poll until the images are ready.
- [List thumbnails](https://tryunsora.com/docs/api-reference/thumbnails/list.md): Paginated list of all thumbnail generations for the authenticated user, including status and finished thumbnail images.
- [Get thumbnail](https://tryunsora.com/docs/api-reference/thumbnails/get.md): Fetch one thumbnail generation job by ID, including its status, source context, and finished thumbnail images ready for download.
- [Delete thumbnail](https://tryunsora.com/docs/api-reference/thumbnails/delete.md): Permanently delete a thumbnail generation and its images from your Unsora account. This action cannot be undone.
- [Create clipping](https://tryunsora.com/docs/api-reference/clippings/create.md): Start an AI clipping job that finds the best moments in a long video and turns them into short, ready-to-post vertical clips with captions.
- [List clipping jobs](https://tryunsora.com/docs/api-reference/clippings/list.md): Paginated list of all AI clipping jobs for the authenticated user, including status, source videos, and generated clips.
- [Get clipping job](https://tryunsora.com/docs/api-reference/clippings/get.md): Fetch a single AI clipping job by ID with its status, source video, and the list of generated clips with captions and timestamps.
- [Delete clipping job](https://tryunsora.com/docs/api-reference/clippings/delete.md): Permanently delete a clipping job and all of its generated clips from your Unsora account. This action cannot be undone.
- [Upload media](https://tryunsora.com/docs/api-reference/uploads/create.md): Import a file into your Unsora media library from a public URL or base64 payload, ready to use in posts, clipping jobs, and generations.
- [Mint signed upload URL](https://tryunsora.com/docs/api-reference/uploads/signed-url.md): Get a direct-to-storage signed upload URL for large files, then register the finished upload as a media library asset.
- [Complete upload](https://tryunsora.com/docs/api-reference/uploads/complete.md): Register a file uploaded via signed URL as a media library asset so it can be used in posts, clips, and generation jobs.
- [List uploads](https://tryunsora.com/docs/api-reference/uploads/list.md): Paginated list of your uploaded media assets, including file type, size, and URLs, ready to attach to posts and generation jobs.
- [Delete upload](https://tryunsora.com/docs/api-reference/uploads/delete.md): Delete an uploaded asset and its stored file from your Unsora media library. Posts that already used the file are unaffected.

## OpenAPI Specs

- [openapi](/docs/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.