URL to Video

Describe the process of analyzing a given URL and creating video content.

1. Make a request

Please request project creation by forwarding the URL and option.

1-1. API endpoint

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

1-2. Request parameter

key	desc	type	required	default
url	Reference URL 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/url_to_video  \
-H "Authorization: ${API KEY}" \
-H "Content-Type: application/json" \
-X POST \
-d '{
    "url" : "https://www.kedglobal.com/artificial-intelligence/newsView/ked202411280004",
    "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/url_to_video', 
    {
        "url" : "https://www.kedglobal.com/artificial-intelligence/newsView/ked202411280004",
        "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/url_to_video"
body = {
    "url" : "https://www.kedglobal.com/artificial-intelligence/newsView/ked202411280004",
    "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.