> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.simplified.com/api-reference/video-tools/video/create-repurpose-project/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.simplified.com/_mcp/server. # Media · Video · Repurpose media into short clips POST https://api.simplified.com/api/v2/repurpose Content-Type: application/json Creates a clip project from a downloadable media source. Supports direct media URLs, YouTube (youtube.com or youtu.be), Vimeo, and Google Drive file links that the service can download. Private or login-only sources and arbitrary landing pages are not guaranteed. Costs credits. Returns immediately with the project id, not a task_id. Poll getRepurposeProject until job_status is DONE or UPDATED; FAILED is terminal. Then use listRepurposeClips for individual clip status and download URLs. Clips render asynchronously. Reference: https://docs.simplified.com/api-reference/video-tools/video/create-repurpose-project ## Authentication - `Authorization` header (required) (prefixed with ` Api-Key `) — Header authentication of the form `Api-Key ` - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, where token is your auth token. ## Request ### Body (application/json) This endpoint expects an object. - `title` (string, required) - `media_url` (string, required) — Downloadable source media file or supported YouTube, Vimeo, or Google Drive file URL. For a Simplified asset, resolve its fresh file URL first; an asset UUID is not a URL. Preserve signed query parameters. - `project_type` (enum, optional, default: V) — V for source video; A for source audio/podcast. - Allowed values: `V`, `A` - `duration` (enum, optional, default: 58) — Target clip length in seconds (58 is the one-minute preset). - Allowed values: `15`, `30`, `58`, `180`, `300` - `aspect_ratio` (enum, optional, default: youtube-shorts) - Allowed values: `youtube-shorts`, `youtube-video`, `instagram-post-video` - `clip_layout` (enum, optional, default: auto) - Allowed values: `auto`, `just_active_speaker`, `center_fit` - `language_code` (string, optional, default: en-US) - `brand_kit_config` (BrandKitConfig, optional) ## Response ### 201 Resource or asynchronous submission result. - `id` (string, optional) - `story_id` (string, optional) - `title` (string, optional) - `media_url` (string, optional) - `project_type` (enum, optional) - Allowed values: `V`, `A` - `job_status` (string, optional) ## Types ### BrandKitConfig - `logo_id` (string, optional, nullable) - `caption_style_id` (string, optional, nullable) ## Examples **Request** ```json { "title": "string", "media_url": "string" } ``` **Response** ```json { "id": "string", "story_id": "string", "title": "string", "media_url": "string", "project_type": "V", "job_status": "string" } ``` **SDK Code** ```python import requests url = "https://api.simplified.com/api/v2/repurpose" payload = { "title": "string", "media_url": "string" } headers = { "Authorization": "Api-Key ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.simplified.com/api/v2/repurpose'; const options = { method: 'POST', headers: {Authorization: 'Api-Key ', 'Content-Type': 'application/json'}, body: '{"title":"string","media_url":"string"}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.simplified.com/api/v2/repurpose" payload := strings.NewReader("{\n \"title\": \"string\",\n \"media_url\": \"string\"\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Api-Key ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.simplified.com/api/v2/repurpose") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Api-Key ' request["Content-Type"] = 'application/json' request.body = "{\n \"title\": \"string\",\n \"media_url\": \"string\"\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.simplified.com/api/v2/repurpose") .header("Authorization", "Api-Key ") .header("Content-Type", "application/json") .body("{\n \"title\": \"string\",\n \"media_url\": \"string\"\n}") .asString(); ``` ```php request('POST', 'https://api.simplified.com/api/v2/repurpose', [ 'body' => '{ "title": "string", "media_url": "string" }', 'headers' => [ 'Authorization' => 'Api-Key ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.simplified.com/api/v2/repurpose"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Api-Key "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"title\": \"string\",\n \"media_url\": \"string\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "Authorization": "Api-Key ", "Content-Type": "application/json" ] let parameters = [ "title": "string", "media_url": "string" ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.simplified.com/api/v2/repurpose")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```