Skip to main content

​
Get a Cosmos API token

Follow the steps in Authentication to get a Cosmos API token.

​
Edit a file

  1. Make a POST request to /v1/edits to create an Edit with Cosmos.
In the request body, include the URL of the file to edit as an item in the assets array. If your file is not hosted, you may upload it to Cosmos for hosting. Check out the Uploads guide here. Specify the edit to apply in the commands array. All supported edit commands can be seen here.
Example Request
  curl --location --request POST 'https://api.golivecosmos.com/v1/edits' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data-raw '{
      "commands": ["image-to-video"],
      "assets": [
        { "type": "image", "src": "https://picsum.photos/200/300" }
      ],
      "options": { "fps": 24, "duration": 5 }
  }'
  1. After creating an Edit, the Cosmos API will return an Edit document with an ID and status. Use the returned ID to make a GET request to /v1/edits/:id to check the status of your edited media. When the status reads done, you’ll see a downloadUrls attribute to download the edited files.
Example Request
  curl --location --request GET 'https://api.golivecosmos.com/v1/edits/647f79a222e224369dbf7e92' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  1. That’s it! That’s all you need to do edit media with Cosmos.