Video
Video generation and avatar operations
List all available avatars for video generation
Successful response
Unauthorized
GET /video/GetAvatars HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
{
"id": "text",
"name": "text",
"gender": "M"
}
]List all shorts videos for the authenticated user (includes pending, processing, completed, and failed)
Successful response
Unauthorized
GET /video/GetShorts HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
{
"id": "text",
"status": 1,
"requestedOn": "2025-10-17T19:44:16.784Z",
"processingOn": "2025-10-17T19:44:16.784Z",
"succeededOn": "2025-10-17T19:44:16.784Z",
"requestTypeId": 1,
"callbackData": "text",
"audioUrl": "text",
"videoUrl": "text",
"imageUrl": "text",
"audioTitle": "text",
"responseText": "text",
"errorOn": "2025-10-17T19:44:16.784Z",
"errorMessage": "text"
}
]Create short videos from audio content or feeds
URL to the audio file to create shorts from (optional if feedIds provided)
Array of feed IDs to generate content from (optional if audioUrl provided)
Optional instructions for short creation
ID of the first avatar to use
Optional ID of the second avatar to use
Optional boolean to include subtitles (default: true)
Optional data to include in webhooks
Optional date/time to schedule the request for processing
Request accepted
Invalid request
Unauthorized
POST /video/CreateShorts HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 168
{
"audioUrl": "text",
"feedIds": [
"text"
],
"prompt": "text",
"avatar1": "text",
"avatar2": "text",
"subtitles": true,
"callbackData": "text",
"scheduledOn": "2025-10-17T19:44:16.784Z"
}{
"requestId": "text",
"status": 1
}Create short videos from text content or feeds
Text content to create shorts from (optional if feedIds provided)
Array of feed IDs to generate content from (optional if content provided)
Optional instructions for short creation
ID of the first avatar to use
Optional ID of the second avatar to use
Optional boolean to include subtitles (default: true)
Optional data to include in webhooks
Optional date/time to schedule the request for processing
Request accepted
Invalid request
Unauthorized
POST /video/CreateShortsFromContent HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 167
{
"content": "text",
"feedIds": [
"text"
],
"prompt": "text",
"avatar1": "text",
"avatar2": "text",
"subtitles": true,
"callbackData": "text",
"scheduledOn": "2025-10-17T19:44:16.784Z"
}{
"requestId": "text",
"status": 1
}Create short videos from a custom script with avatar dialogue or from feeds
Array of feed IDs to generate content from (optional if script provided)
Optional boolean to include subtitles (default: true)
Optional data to include in webhooks
Optional date/time to schedule the request for processing
Request accepted
Invalid request
Unauthorized
POST /video/CreateShortsFromScript HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 140
{
"script": [
{
"avatarId": 1,
"text": "text"
}
],
"feedIds": [
"text"
],
"subtitles": true,
"callbackData": "text",
"scheduledOn": "2025-10-17T19:44:16.784Z"
}{
"requestId": "text",
"status": 1
}Create short videos from the results of a completed deep research
ID of the completed deep research to create shorts from
Optional instructions for short creation
ID of the first avatar to use
Optional ID of the second avatar to use
Optional boolean to include subtitles (default: true)
Optional data to include in webhooks
Optional date/time to schedule the request for processing
Request accepted
Invalid request
Unauthorized
Deep research not found or not accessible
POST /video/CreateShortsFromDeepResearch HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 155
{
"deepResearchId": "text",
"prompt": "text",
"avatar1": "text",
"avatar2": "text",
"subtitles": true,
"callbackData": "text",
"scheduledOn": "2025-10-17T19:44:16.784Z"
}{
"requestId": "text",
"status": 1
}Create a new talking head avatar from text or image
Name for the avatar
Optional URL to an image to use as the base for the avatar
Optional text prompt describing the avatar (used when imageUrl is not provided)
Optional ID of the voice to use for the avatar
Optional data to include in webhooks
Optional date/time to schedule the request for processing
Request accepted
Invalid request
Unauthorized
POST /video/CreateAvatar HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 124
{
"name": "text",
"imageUrl": "text",
"prompt": "text",
"voiceId": 1,
"callbackData": "text",
"scheduledOn": "2025-10-17T19:44:16.784Z"
}{
"requestId": "text",
"status": 1
}Update the voice assigned to an existing avatar
ID of the avatar to update
ID of the new voice to assign to the avatar
Avatar voice updated successfully
Invalid request (missing or invalid parameters)
Unauthorized
Avatar not found or not accessible
Failed to update avatar voice
POST /video/UpdateAvatarVoice HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 26
{
"avatarId": 1,
"voiceId": 1
}{
"success": true,
"message": "text"
}List all explainer videos for the authenticated user
Successful response
Unauthorized
Internal server error
GET /video/GetExplainerVideos HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
{
"id": "text",
"title": "text",
"description": "text",
"videoUrl": "text",
"fileSize": 1,
"durationSeconds": 1,
"shareUrl": "text",
"createdOn": "2025-10-17T19:44:16.784Z",
"requestedOn": "2025-10-17T19:44:16.784Z",
"succeededOn": "2025-10-17T19:44:16.784Z",
"status": 1,
"errorOn": "2025-10-17T19:44:16.784Z",
"errorMessage": "text",
"callbackData": "text",
"scheduledOn": "2025-10-17T19:44:16.784Z"
}
]Create an explainer video from a topic or URL with optional avatar and language
Duration of the video in seconds (10-300, default 30)
Topic for the explainer video (optional if url provided)
URL to analyze for content (optional if topic provided)
Optional ID of the avatar to use for the video
Optional ID of the voice to use for the video (used when avatarId is not provided)
Optional language for the audio narration (e.g., "English", "español", "français")
EnglishOptional language for the text/subtitles (e.g., "English", "español", "français")
EnglishOptional URL to a background image for the video
Optional data to include in webhooks
Optional date/time to schedule the request for processing
Request accepted
Invalid request (missing content source, invalid duration, invalid language, insufficient credits, or invalid avatarId)
Unauthorized
Error validating credits
POST /video/CreateExplainerVideo HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 209
{
"duration": 1,
"topic": "text",
"url": "text",
"avatarId": 1,
"voiceId": 1,
"audioLanguage": "English",
"textLanguage": "English",
"backgroundImageUrl": "text",
"callbackData": "text",
"scheduledOn": "2025-10-17T19:44:16.784Z"
}{
"requestId": "text",
"status": 1
}