URL

The

URL endpoint
allows you to create a video from a URL. To use this endpoint, you must provide a URL for the video as well as any optional parameters such as a template, voice, actor, or music track. The request should be sent as a JSON payload in the body of a POST request to the
/v1/api/videos/create/url
endpoint, with the necessary authorization and content-type headers included.

If you're unsure about the available options for the optional parameters, you can refer to the Catalogue section of the API documentation to retrieve information about actors, voices, templates, and music tracks.

ParameterTypeDescriptionRequired
template_idstringThe identifier of the template to use for the video creation.Yes
voice_idstringThe identifier of the voice to use for the video creation.
actor_idstringThe identifier of the actor to use for the video creation.
music_idstringThe identifier of the music track to use for the video creation.
urlstringThe URL used to generate the video from.Yes
"global": {
  "spec": {
    "target_platform": "Amazon",
    "target_language": "it",
    "target_age_group": {
      "min": 6,
      "max": 12
    },
    "target_gender":"Female"
  }
}
objectThe section specifies the target platform, target language, and target age group for content specifications. Available target platform is 'Amazon', 'Etsy', 'YouTube (Ads)', 'Snap', 'Tik Tok', 'Instagram', 'Facebook', 'LinkedIn'. Available target gender is 'Female', 'Male', 'Male|Female'

HTTP Request

POST https://api.oxolo.com/v1/api/videos/create/url

curl -X 'POST' 
'https://api.oxolo.com/v1/api/videos/create/url' 
-H 'accept: application/json' 
-H 'authorization: YOUR_API_KEY' 
-H 'content-type: application/json' 
-d '{
"template_id": "42b69075-952e-42fe-81d4-dbf8ed35120f",
"url": "https://www.amazon.de/dp/B09B8X9RGM"
}'

{"results": {"identifier": "{VIDEO_IDENTIFIER}"}}