# Visla Documentation

> VIsla Developer Portal

## API Reference
- [Introduction](https://developer.visla.us/reference/introduction.md): An overview of the Visla API — generate videos from text, scripts, audio, images, documents, webpages, or AI-generated visuals, with key features and the full list of available APIs.
- [Video Creation Process](https://developer.visla.us/reference/video-creation-process.md): Learn the steps and key endpoints for creating videos from stock footage using the Visla OpenAPI. For AI-generated visual content, see [AIGC Video Creation Process](/reference/aigc-video-creation-process).
- [AIGC Video Creation Process](https://developer.visla.us/reference/aigc-video-creation-process.md): Learn how to create videos with AI-generated visuals using the Visla OpenAPI. For stock-footage-based video creation, see [Video Creation Process](/reference/video-creation-process).
- [Authentication](https://developer.visla.us/reference/api-authentication.md): This page explains how to authenticate with the API, including required credentials and supported methods.
- [Handling API Responses](https://developer.visla.us/reference/handling-api-responses.md): Learn how to manage both successful and failed responses from the API.
- [Rate Limits](https://developer.visla.us/reference/rate-limits.md): Learn about Visla’s API rate limits, including request quotas, retry behavior, and best practices to avoid exceeding usage thresholds.
- [Webhook Notifications](https://developer.visla.us/reference/webhook-notifications.md): Receive real-time event updates from Visla via webhooks to keep your application synchronized with project, asset, and user activities.
- [Guidelines for Using Script-to-Video API](https://developer.visla.us/reference/guidelines-for-using-script-to-video-api.md): Visla’s API makes it easy to create videos from text-based scripts. Follow these concise guidelines to get started quickly.
- [Troubleshooting](https://developer.visla.us/reference/troubleshooting.md): Resolve common issues and fix errors quickly.
- [Enum Reference](https://developer.visla.us/reference/enum-reference.md): Reference all enums with their values, meanings, and usage examples for easy integration.
- [Get user info](https://developer.visla.us/reference/get-user-info.md): Retrieves details of the current user
- [Create a video project with all data in one request using universal resource model](https://developer.visla.us/reference/create-basic-video.md): Creates a new video project by submitting all resources (script, documents, webpages, media) in a single request.
- [Create video from webpage](https://developer.visla.us/reference/create-video-from-webpage.md): Creates a video project based on the provided URL
- [Create video from doc](https://developer.visla.us/reference/create-video-from-doc.md): Creates a video project based on the provided doc
- [Create a project in one step (all resource types supported)](https://developer.visla.us/reference/generate-video.md): Creates a project with all supported resource types (idea, script/text, webpages, documents, media, clips, etc.).
- [Create a project in one step and auto-export to clip](https://developer.visla.us/reference/generate-video-to-clip.md): Creates a project with all supported resource types (idea, script/text, webpages, documents, media, clips, etc.). Returns project and clip info immediately. Clip content will be populated after generation completes. Sends PROJECT_GENERATION + PROJECT_EXPORT webhooks with download link on completion.
- [Create video from idea](https://developer.visla.us/reference/create-video-from-idea.md): Creates a video project based on the provided idea and immediately starts generation
- [Create video from script](https://developer.visla.us/reference/create-video-from-script.md): Converts the provided script into a video project
- [Create video from speech](https://developer.visla.us/reference/create-video-from-speech.md): Creates a speech-to-video project based on an uploaded audio or video asset
- [Create video from visual resources](https://developer.visla.us/reference/create-video-from-visuals.md): Creates a video project from images, videos, and optional text overlay
- [Create a video project with all data in one request](https://developer.visla.us/reference/create-basic-video-in-teamspace.md): Creates a new video project by submitting all resources (script, documents, webpages, media) in a single request within the specified teamspace.
- [Create a project in one step (all resource types supported)](https://developer.visla.us/reference/generate-video-in-teamspace.md): Creates a project with all supported resource types (idea, script/text, webpages, documents, media, etc.).
- [Create video from webpage in a specific teamspace](https://developer.visla.us/reference/create-video-from-webpage-in-teamspace.md): Creates a video project based on the provided URL within the specified teamspace identified by its UUID
- [Create video from doc in a specific teamspace](https://developer.visla.us/reference/create-video-from-doc-in-teamspace.md): Converts the provided doc into a video project within the specified teamspace identified by its UUID
- [Create video from idea in a specific teamspace](https://developer.visla.us/reference/create-video-from-idea-in-teamspace.md): Creates a video project based on the provided idea within the specified teamspace identified by its UUID
- [Create video from script in a specific teamspace](https://developer.visla.us/reference/create-video-from-script-in-teamspace.md): Converts the provided script into a video project within the specified teamspace identified by its UUID
- [Create video from speech in a specific teamspace](https://developer.visla.us/reference/create-video-from-speech-in-teamspace.md): Creates a speech-to-video project based on an uploaded audio or video asset within the specified teamspace identified by its UUID
- [Create video from visual resources in a specific teamspace](https://developer.visla.us/reference/create-video-from-visuals-in-teamspace.md): Creates a video project from images, videos, and optional text overlay within the specified teamspace identified by its UUID
- [Create a project with AIGC video generation pipeline](https://developer.visla.us/reference/create-aigc-video.md): Creates a project using the AIGC pipeline with visual spec control (style/object/env) and auto motion video generation.
- [Create a project with AIGC pipeline and auto-export to clip](https://developer.visla.us/reference/create-aigc-video-to-clip.md): Creates a project using AIGC pipeline. Returns project and clip info immediately. Clip content will be populated after pipeline completes. Sends PROJECT_GENERATION + PROJECT_EXPORT webhooks with download link on completion.
- [List all AIGC styles](https://developer.visla.us/reference/list-aigc-styles.md): Retrieves the list of available AIGC styles
- [Get AIGC project scene-level info](https://developer.visla.us/reference/get-scene-aigc-info.md): Returns per-scene AIGC status including storyboard and motion video generation progress.
- [Generate or regenerate motion video for a scene](https://developer.visla.us/reference/generate-scene-motion-video.md): Unified endpoint for generating or regenerating motion video. Returns taskId for async tracking. Supports webhook notification.
- [Generate or regenerate storyboard images for scenes](https://developer.visla.us/reference/generate-scene-storyboard-image.md): Unified endpoint for storyboard image generation. Supports force_override_video to allow image generation on scenes that already have a motion video. Credits are pre-estimated per scene; the request is rejected if workspace balance is insufficient.
- [Create a project with AIGC video generation pipeline](https://developer.visla.us/reference/create-aigc-video-in-teamspace.md): Creates a project using the AIGC pipeline with visual spec control (style/object/env) and auto motion video generation.
- [Create a project with AIGC pipeline and auto-export to clip](https://developer.visla.us/reference/create-aigc-video-to-clip-in-teamspace.md): Creates a project using AIGC pipeline. Returns project and clip info immediately. Clip content will be populated after pipeline completes. Sends PROJECT_GENERATION + PROJECT_EXPORT webhooks with download link on completion.
- [Get upload URL for temp storage asset](https://developer.visla.us/reference/get-asset-upload-url.md): Retrieve a presigned URL to upload assets to temporary storage
- [Add documents to project](https://developer.visla.us/reference/add-project-documents.md): Adds one or more document resources (PDF, PPT, etc.) to the specified project.
- [Add media resources to project](https://developer.visla.us/reference/add-project-media.md): Adds one or more media files (audio, video, image) to the specified project.
- [Add uploaded media to project](https://developer.visla.us/reference/add-project-uploaded-media.md): Adds the uploaded media to the specified project identified by its UUID
- [Add webpages to project](https://developer.visla.us/reference/add-project-webpages.md): Adds one or more webpage URLs as reference material to the specified project.
- [Clear project text/script content](https://developer.visla.us/reference/clear-project-text.md): Clears the script or text content of the specified project.
- [Delete documents from project](https://developer.visla.us/reference/delete-project-documents.md): Provide the document URLs or IDs to be deleted
- [Delete media from project](https://developer.visla.us/reference/delete-project-media.md): Deletes one or more media resources from the specified project.
- [Delete webpages from project](https://developer.visla.us/reference/delete-project-webpages.md): Provide the webpage URLs to be deleted
- [Detect project function and parameters](https://developer.visla.us/reference/detect-project-function.md): Analyzes the specified project and auto-detects the recommended project function/type and parameters based on its current content.
- [Export project](https://developer.visla.us/reference/export-project-video.md): Exports the video for the specified project identified by its UUID. The exported video will be saved as a clip in your teamspace
- [Generate video](https://developer.visla.us/reference/generate-project-video.md): Generates the video for the specified project identified by its UUID based on the current settings and resources
- [Get consumed credit](https://developer.visla.us/reference/get-project-consumed-credit.md): Retrieves the amount of credit consumed by the specified project identified by its UUID
- [Get project description/idea content](https://developer.visla.us/reference/get-project-description.md): Retrieves the description or idea content of the specified project.
- [List uploaded media](https://developer.visla.us/reference/list-project-media.md): Retrieves the list of media files associated with the specified project identified by its UUID
- [Get available project functions](https://developer.visla.us/reference/get-project-functions.md): Retrieves the list of available project functions/types from AgentProjectAttributes.
- [Get project text/script content](https://developer.visla.us/reference/get-project-text.md): Retrieves the script or text content of the specified project.
- [Get project info](https://developer.visla.us/reference/get-project-info.md): Retrieves details of a specific project by its UUID
- [List uploaded doc](https://developer.visla.us/reference/list-project-documents.md): Retrieve a list of documents uploaded to the specified project
- [Set project background image](https://developer.visla.us/reference/set-project-background-image.md): Sets the background image for the specified project.
- [Update project description/idea](https://developer.visla.us/reference/update-project-description.md): Updates the description or idea of the specified project.
- [Set project function](https://developer.visla.us/reference/set-project-function.md): Set the project function/type
- [Update project text/script content](https://developer.visla.us/reference/update-project-text.md): Updates the script or text content of the specified project.
- [Get clip download link](https://developer.visla.us/reference/get-clip-download-link.md): Returns a temporary download link for the specified clip identified by its UUID
- [Get clip info](https://developer.visla.us/reference/get-clip-info.md): Retrieves detailed information about a specific clip identified by its UUID
- [Add clip](https://developer.visla.us/reference/add-clip-to-folder.md): Adds a clip to the specified folder identified by its UUID
- [List clip](https://developer.visla.us/reference/list-folder-clips.md): Retrieves a list of clips within the specified folder identified by its UUID
- [List project](https://developer.visla.us/reference/list-folder-projects.md): Retrieves a list of projects within the specified folder identified by its UUID
- [Set workspace intro clip](https://developer.visla.us/reference/set-workspace-intro.md): Sets workspace-level intro by clipUuid only. assetUuid is not supported.
- [Set workspace outro clip](https://developer.visla.us/reference/set-workspace-outro.md): Sets workspace-level outro by clipUuid only. assetUuid is not supported.
- [Set workspace watermark](https://developer.visla.us/reference/set-workspace-watermark.md): Sets the watermark settings for the current workspace, including custom watermark image, position, opacity, and Visla watermark visibility
- [Set intro/outro usage switches](https://developer.visla.us/reference/set-workspace-inoutro-usage.md): Sets workspace-level switches: useInClip, useInProject, useIntroInProject and useOutroInProject
- [Get workspace credit balance](https://developer.visla.us/reference/get-workspace-credit-balance.md): Retrieves the current credit balance for the workspace
- [Get workspace credit detail](https://developer.visla.us/reference/get-workspace-credit-detail.md): Retrieves the credit details for the current workspace
- [List avatar](https://developer.visla.us/reference/list-workspace-avatars.md): Returns a list of available avatars that can be used when creating a video project within a workspace
- [List teamspace](https://developer.visla.us/reference/list-workspace-teamspaces.md): Retrieves a list of teamspaces that the current workspace is either a member of or owns
- [List voice](https://developer.visla.us/reference/list-workspace-voices.md): Returns a list of available voices that can be used when creating a video project within a workspace
- [Get workspace info](https://developer.visla.us/reference/get-workspace-info.md): Retrieves information about the current workspace
- [Create audio project in a specific teamspace](https://developer.visla.us/reference/create-audio-project-in-teamspace.md): Creates a new blank audio project within the specified teamspace identified by its UUID
- [Add clip](https://developer.visla.us/reference/add-clip-to-teamspace.md): Adds a clip to the specified teamspace identified by its UUID
- [Get clip upload URL](https://developer.visla.us/reference/get-teamspace-clip-upload-url.md): Retrieves a temporary upload URL for adding clips to the specified teamspace identified by its UUID
- [Get teamspace info](https://developer.visla.us/reference/get-teamspace-info.md): Retrieves information about the specified teamspace identified by its UUID
- [List clip](https://developer.visla.us/reference/list-teamspace-clips.md): Retrieves a list of clips within the specified teamspace identified by its UUID
- [List project](https://developer.visla.us/reference/list-teamspace-projects.md): Retrieves a list of projects within the specified teamspace identified by its UUID
- [List stock](https://developer.visla.us/reference/list-teamspace-stock.md): Retrieves a list of stock items within the specified teamspace identified by its UUID

## Changelog
- [AIGC Video & New Creation APIs](https://developer.visla.us/changelog/aigc-video-new-creation-apis.md)
- [Expanded Video Creation Capabilities](https://developer.visla.us/changelog/expanded-video-creation-capabilities.md)
- [Visla Agent Skills](https://developer.visla.us/changelog/visla-agent-skills.md)