Video
Video generation and avatar operations
List all available avatars for video generation
Successful response
Avatar identifier
Avatar display name
Avatar gender (M = Male, F = Female)
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
Short video identifier
Status code (0 = pending, 10-90 = processing, 100 = completed, -1 = failed)
Request creation date
Processing start date
Completion date
Request type ID (4 = Short)
Custom callback data
URL to the audio used for the short
URL to the generated short video (when completed)
URL to the thumbnail image (when completed)
Title of the short video
Text content used in the short
Error occurrence date (if applicable)
Error message (if applicable)
Unauthorized
GET /video/GetShorts HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
{
"id": "text",
"status": 1,
"requestedOn": "2026-01-01T00:00:00.000Z",
"processingOn": "2026-01-01T00:00:00.000Z",
"succeededOn": "2026-01-01T00:00:00.000Z",
"requestTypeId": 1,
"callbackData": "text",
"audioUrl": "text",
"videoUrl": "text",
"imageUrl": "text",
"audioTitle": "text",
"responseText": "text",
"errorOn": "2026-01-01T00:00:00.000Z",
"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
Request identifier
Initial status code (0 = pending)
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": "2026-01-01T00:00:00.000Z"
}{
"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
Request identifier
Initial status code (0 = pending)
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": "2026-01-01T00:00:00.000Z"
}{
"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
Request identifier
Initial status code (0 = pending)
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": "2026-01-01T00:00:00.000Z"
}{
"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
Request identifier
Initial status code (0 = pending)
Invalid request, expired subscription, or insufficient credits
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": "2026-01-01T00:00:00.000Z"
}{
"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 numeric voice id from /content/GetVoices to use for the avatar
Optional data to include in webhooks
Optional date/time to schedule the request for processing
Request accepted
Request identifier
Initial status code (0 = pending)
Invalid request, expired subscription, or insufficient credits
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": "2026-01-01T00:00:00.000Z"
}{
"requestId": "text",
"status": 1
}Update the voice assigned to an existing avatar
ID of the avatar to update
Numeric voice id from /content/GetVoices to assign to the avatar
Avatar voice updated successfully
Success status
Success message
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
Video explainer identifier (matches request ID)
Title of the explainer video
Description of the explainer video
URL to the explainer video
Size of the video file in bytes
Duration of the video in seconds
Shareable public URL for the video
Creation date of the explainer video
Request creation date
Completion date
Status code (100 = completed)
Error occurrence date (if applicable)
Error message (if applicable)
Custom callback data
Scheduled processing time (if applicable)
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": "2026-01-01T00:00:00.000Z",
"requestedOn": "2026-01-01T00:00:00.000Z",
"succeededOn": "2026-01-01T00:00:00.000Z",
"status": 1,
"errorOn": "2026-01-01T00:00:00.000Z",
"errorMessage": "text",
"callbackData": "text",
"scheduledOn": "2026-01-01T00:00:00.000Z"
}
]Submit a transcription job for an explainer video by ID
Explainer video ID (request ID)
Transcription request accepted
Invalid request (missing videoId), expired subscription, or insufficient credits
Unauthorized
Explainer video not found or not ready
POST /video/Transcribe HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 18
{
"videoId": "text"
}{
"request_id": "text",
"status": 1
}Retrieve the transcript for a completed explainer video
Explainer video ID (request ID)
Transcript retrieved successfully
Explainer video identifier (request ID)
Transcript creation timestamp
Unauthorized
Transcript not found for the specified explainer video
GET /video/Transcript/{videoId} HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"videoId": "text",
"createdOn": "2026-01-01T00:00:00.000Z",
"transcript": [
{
"text": "text",
"speaker": "text",
"timestamp": [
1
]
}
]
}Generate the branded intro image used for explainer videos and download the PNG asset.
Title text rendered on the intro image.
Optional subtitle text displayed beneath the title.
Optional logo URL to render on the intro image.
Optional hero/background image URL composited into the intro artwork.
PNG image download containing the branded intro artwork.
Missing or invalid query parameters, or expired subscription.
Unauthorized
Error generating or uploading the intro image
GET /video/GenerateIntroImage?title=text HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
binaryLast updated