Scripts to Video

Describe the process of creating video content based on a given sentence.

1. Make a request

Please request project creation by delivering sentences and options.

1. API endpoint

https://app.aistudios.com/api/odin/v3/automation/scripts_to_video

1-2. Request parameter

key	desc	type	required	default
scripts	Sentence for creating a video	String	true	-
options	Configuration for video generation	Json	false	{}
options.goal	Purpose of video generation	'auto', 'business', 'youtube', 'education'	false	'business'
options.duration	Video Time	'auto', '30', '60', '90', '120'	false	'auto'
options.speed	Video playback speed relative to original speed	'auto', Number	false	-
options.language	The language used in the video. The language code follows the ISO 639-1 standard.	'auto', String	false	-
options.media	Image information used to create video (valid only for options.filebackground=false)	'auto', 'search', 'free', 'generative'	false	-
options.style	Style information (valid only for options.media='generative')	'auto', 'business', 'youtube', 'education'	false	-
options.fileBackground	Whether to use the file you provided in the background of the video	Boolean	false	true
options.orientation	Screen orientation of the created video	'web', 'mobile'	false	'web'
options.model	ID of the AI model to use for video generation

1-3. Response Parameters

key	desc	type
projectId	ID of the video project created	String
automationJobId	Job ID requested to create a video	String

1-4. Sample Request

cURL

curl https://app.aistudios.com/api/odin/v3/automation/scripts_to_video  \
-H "Authorization: ${API KEY}" \
-H "Content-Type: application/json" \
-X POST \
-d '{
    "scripts" : "Lorem Ipsum is simply dummy text of the printing and typesetting industry.\nLorem Ipsum has been the industrys standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book.",
    "options" : {
        "goal" : "youtube",
        "duration" : 30, 
    }
}'

Node.js

import axios from "axios"; 
const token = ${API KEY};
const customWebhookUrl = ${webhook_delivery_address};

axios.post('https://app.aistudios.com/api/odin/v3/automation/scripts_to_video', 
    {
        "scripts" : "Lorem Ipsum is simply dummy text of the printing and typesetting industry.\nLorem Ipsum has been the industrys standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book.",
        "options" : {
            "goal" : "youtube",
            "duration" : 30, 
        }
    }, 
    {
        headers: {
            'Authorization': ${token},
            'Content-Type': 'application/json'
        }
    }
)
.then((res) => {
  console.log(res.data);
})
.catch((error) => {
  console.error(error);
})

Python

import requests
import json

url = "https://app.aistudios.com/api/odin/v3/automation/scripts_to_video"
body = {
    "scripts" : "Lorem Ipsum is simply dummy text of the printing and typesetting industry.\nLorem Ipsum has been the industrys standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book.",
    "options" : {
        "goal" : "youtube",
        "duration" : 30, 
    }
}
    
headers = {
  "Content-Type": "application/json",
  "Authorization": ${API TOKEN}
}

r = requests.post(url, data=json.dumps(body), headers=headers)

2. Check the progress of project creation

Create a video after request Check your current progress.

2-1. Api endpoint

GET https://app.aistudios.com/api/odin/v3/automation/progress?projectId=${projectId}

2-2. Response Parameters

Key	Description	Type
state	Current state of the automation process	String
progress	Video Generation Completion Rate	Number

2-3. Sample request

import axios from "axios";

const projectId = "your_project_id";
const token = "your_api_key";

axios.get(`https://app.aistudios.com/api/odin/v3/automation/progress/${projectId}`, {}, {
  headers: {
    "Authorization": token,
    "Content-Type": "application/json"
  }
})
.then((res) => {
  console.log(res.data)
})
.catch((error) => {
  console.error(error)
});

3. Export

Use Project Export to Project a video of a created project.