Skip to main content
POST
Generate Replace Actor Video

Authorizations

Authorization
string
header
default:ta_live_your_api_key
required

Your TurboAds API key

Body

application/json

Provide either image_file_id and video_file_id from file uploads, or image_url and video_url.

project_id
string
required

Existing project ID in the API key workspace.

image_url
string<uri>

Public character image URL. Use image_file_id instead when uploading through the API.

video_url
string<uri>

Public motion reference video URL. Use video_file_id instead when uploading through the API.

prompt
string

Optional context for the replacement job.

duration
number
default:30

Reference video duration in seconds.

Required range: 3 <= x <= 30
aspect_ratio
enum<string>
default:9:16
Available options:
1:1,
9:16,
16:9
image_file_id
string

Completed image file upload ID for the replacement character image.

video_file_id
string

Completed video file upload ID for the motion reference video.

Response

Replace Actor generation job created

data
object
required