Video

Video generation and avatar operations

Get available avatars

get

List all available avatars for video generation

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Successful response

application/json

idstringOptional

Avatar identifier

namestringOptional

Avatar display name

genderstring · enumOptional

Avatar gender (M = Male, F = Female)

Possible values:

401

Unauthorized

get

/video/GetAvatars

HTTPcURLJavaScriptPython

GET /video/GetAvatars HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "text",
    "name": "text",
    "gender": "M"
  }
]

Get shorts videos

get

List all shorts videos for the authenticated user (includes pending, processing, completed, and failed)

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Successful response

application/json

idstringOptional

Short video identifier

statusintegerOptional

Status code (0 = pending, 10-90 = processing, 100 = completed, -1 = failed)

requestedOnstring · date-timeOptional

Request creation date

processingOnstring · date-timeOptional

Processing start date

succeededOnstring · date-timeOptional

Completion date

requestTypeIdintegerOptional

Request type ID (4 = Short)

callbackDatastringOptional

Custom callback data

audioUrlstringOptional

URL to the audio used for the short

videoUrlstringOptional

URL to the generated short video (when completed)

imageUrlstringOptional

URL to the thumbnail image (when completed)

audioTitlestringOptional

Title of the short video

responseTextstringOptional

Text content used in the short

errorOnstring · date-timeOptional

Error occurrence date (if applicable)

errorMessagestringOptional

Error message (if applicable)

401

Unauthorized

get

/video/GetShorts

HTTPcURLJavaScriptPython

GET /video/GetShorts HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "text",
    "status": 1,
    "requestedOn": "2026-03-17T21:13:59.422Z",
    "processingOn": "2026-03-17T21:13:59.422Z",
    "succeededOn": "2026-03-17T21:13:59.422Z",
    "requestTypeId": 1,
    "callbackData": "text",
    "audioUrl": "text",
    "videoUrl": "text",
    "imageUrl": "text",
    "audioTitle": "text",
    "responseText": "text",
    "errorOn": "2026-03-17T21:13:59.422Z",
    "errorMessage": "text"
  }
]

Create shorts

post

Create short videos from audio content or feeds

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

audioUrlstringOptional

URL to the audio file to create shorts from (optional if feedIds provided)

feedIdsstring[]Optional

Array of feed IDs to generate content from (optional if audioUrl provided)

promptstringOptional

Optional instructions for short creation

avatar1stringRequired

ID of the first avatar to use

avatar2stringOptional

Optional ID of the second avatar to use

subtitlesbooleanOptional

Optional boolean to include subtitles (default: true)

callbackDatastringOptional

Optional data to include in webhooks

scheduledOnstring · date-timeOptional

Optional date/time to schedule the request for processing

Responses

200

Request accepted

application/json

requestIdstringOptional

Request identifier

statusintegerOptional

Initial status code (0 = pending)

400

Invalid request

401

Unauthorized

post

/video/CreateShorts

HTTPcURLJavaScriptPython

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-03-17T21:13:59.422Z"
}

{
  "requestId": "text",
  "status": 1
}

Create shorts from text

post

Create short videos from text content or feeds

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

contentstringOptional

Text content to create shorts from (optional if feedIds provided)

feedIdsstring[]Optional

Array of feed IDs to generate content from (optional if content provided)

promptstringOptional

Optional instructions for short creation

avatar1stringRequired

ID of the first avatar to use

avatar2stringOptional

Optional ID of the second avatar to use

subtitlesbooleanOptional

Optional boolean to include subtitles (default: true)

callbackDatastringOptional

Optional data to include in webhooks

scheduledOnstring · date-timeOptional

Optional date/time to schedule the request for processing

Responses

200

Request accepted

application/json

requestIdstringOptional

Request identifier

statusintegerOptional

Initial status code (0 = pending)

400

Invalid request

401

Unauthorized

post

/video/CreateShortsFromContent

HTTPcURLJavaScriptPython

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-03-17T21:13:59.422Z"
}

{
  "requestId": "text",
  "status": 1
}

Create shorts from script

post

Create short videos from a custom script with avatar dialogue or from feeds

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

feedIdsstring[]Optional

Array of feed IDs to generate content from (optional if script provided)

subtitlesbooleanOptional

Optional boolean to include subtitles (default: true)

callbackDatastringOptional

Optional data to include in webhooks

scheduledOnstring · date-timeOptional

Optional date/time to schedule the request for processing

Responses

200

Request accepted

application/json

requestIdstringOptional

Request identifier

statusintegerOptional

Initial status code (0 = pending)

400

Invalid request

401

Unauthorized

post

/video/CreateShortsFromScript

HTTPcURLJavaScriptPython

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-03-17T21:13:59.422Z"
}

{
  "requestId": "text",
  "status": 1
}

Create shorts from deep research

post

Create short videos from the results of a completed deep research

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

deepResearchIdstringRequired

ID of the completed deep research to create shorts from

promptstringOptional

Optional instructions for short creation

avatar1stringRequired

ID of the first avatar to use

avatar2stringOptional

Optional ID of the second avatar to use

subtitlesbooleanOptional

Optional boolean to include subtitles (default: true)

callbackDatastringOptional

Optional data to include in webhooks

scheduledOnstring · date-timeOptional

Optional date/time to schedule the request for processing

Responses

200

Request accepted

application/json

requestIdstringOptional

Request identifier

statusintegerOptional

Initial status code (0 = pending)

400

Invalid request

401

Unauthorized

404

Deep research not found or not accessible

post

/video/CreateShortsFromDeepResearch

HTTPcURLJavaScriptPython

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-03-17T21:13:59.422Z"
}

{
  "requestId": "text",
  "status": 1
}

Create avatar

post

Create a new talking head avatar from text or image

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/jsonmultipart/form-data

namestringRequired

Name for the avatar

imageUrlstringOptional

Optional URL to an image to use as the base for the avatar

promptstringOptional

Optional text prompt describing the avatar (used when imageUrl is not provided)

voiceIdintegerOptional

Optional ID of the voice to use for the avatar

callbackDatastringOptional

Optional data to include in webhooks

scheduledOnstring · date-timeOptional

Optional date/time to schedule the request for processing

Responses

200

Request accepted

application/json

requestIdstringOptional

Request identifier

statusintegerOptional

Initial status code (0 = pending)

400

Invalid request

401

Unauthorized

post

/video/CreateAvatar

HTTPcURLJavaScriptPython

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-03-17T21:13:59.422Z"
}

application/jsonmultipart/form-data

{
  "requestId": "text",
  "status": 1
}

Update avatar voice

post

Update the voice assigned to an existing avatar

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

avatarIdintegerRequired

ID of the avatar to update

voiceIdintegerRequired

ID of the new voice to assign to the avatar

Responses

200

Avatar voice updated successfully

application/json

successbooleanOptional

Success status

messagestringOptional

Success message

400

Invalid request (missing or invalid parameters)

401

Unauthorized

404

Avatar not found or not accessible

500

Failed to update avatar voice

post

/video/UpdateAvatarVoice

HTTPcURLJavaScriptPython

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"
}

Get explainer videos

get

List all explainer videos for the authenticated user

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Successful response

application/json

idstringOptional

Video explainer identifier (matches request ID)

titlestringOptional

Title of the explainer video

descriptionstringOptional

Description of the explainer video

videoUrlstringOptional

URL to the explainer video

fileSizeintegerOptional

Size of the video file in bytes

durationSecondsintegerOptional

Duration of the video in seconds

shareUrlstringOptional

Shareable public URL for the video

createdOnstring · date-timeOptional

Creation date of the explainer video

requestedOnstring · date-timeOptional

Request creation date

succeededOnstring · date-timeOptional

Completion date

statusintegerOptional

Status code (100 = completed)

errorOnstring · date-timeOptional

Error occurrence date (if applicable)

errorMessagestringOptional

Error message (if applicable)

callbackDatastringOptional

Custom callback data

scheduledOnstring · date-timeOptional

Scheduled processing time (if applicable)

401

Unauthorized

500

Internal server error

get

/video/GetExplainerVideos

HTTPcURLJavaScriptPython

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-03-17T21:13:59.422Z",
    "requestedOn": "2026-03-17T21:13:59.422Z",
    "succeededOn": "2026-03-17T21:13:59.422Z",
    "status": 1,
    "errorOn": "2026-03-17T21:13:59.422Z",
    "errorMessage": "text",
    "callbackData": "text",
    "scheduledOn": "2026-03-17T21:13:59.422Z"
  }
]

Transcribe an explainer video

post

Submit a transcription job for an explainer video by ID

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

videoIdstringRequired

Explainer video ID (request ID)

Responses

200

Transcription request accepted

application/json

request_idstringOptional

statusintegerOptional

400

Invalid request (missing videoId)

401

Unauthorized

404

Explainer video not found or not ready

post

/video/Transcribe

HTTPcURLJavaScriptPython

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
}

Get an explainer transcript

get

Retrieve the transcript for a completed explainer video

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

videoIdstringRequired

Explainer video ID (request ID)

Responses

200

Transcript retrieved successfully

application/json

videoIdstringOptional

Explainer video identifier (request ID)

createdOnstring · date-timeOptional

Transcript creation timestamp

401

Unauthorized

404

Transcript not found for the specified explainer video

get

/video/Transcript/{videoId}

HTTPcURLJavaScriptPython

GET /video/Transcript/{videoId} HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "videoId": "text",
  "createdOn": "2026-03-17T21:13:59.422Z",
  "transcript": [
    {
      "text": "text",
      "speaker": "text",
      "timestamp": [
        1
      ]
    }
  ]
}

Generate branded intro image

get

Generate the branded intro image used for explainer videos and download the PNG asset.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

titlestringRequired

Title text rendered on the intro image.

subtitlestringOptional

Optional subtitle text displayed beneath the title.

logoUrlstringOptional

Optional logo URL to render on the intro image.

heroImageUrlstringOptional

Optional hero/background image URL composited into the intro artwork.

Responses

200

PNG image download containing the branded intro artwork.

image/png

Responsestring · binary

400

Missing or invalid query parameters.

401

Unauthorized

500

Error generating or uploading the intro image

get

/video/GenerateIntroImage

HTTPcURLJavaScriptPython

GET /video/GenerateIntroImage?title=text HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

binary