API Reference

Here you can find all the methods and properties of our API.

File Upload

Retrieve a signed URL to upload a file to our temporary server. More info here.

`GET /upload`

Example Request:

curl --request GET \
	--url https://developer-api.moises.ai/api/upload \
	--header 'Authorization: your-api-key-here'

Example Response:

{
  "uploadUrl": "https://storage.googleapis.com/moises/939b7898b3ef?(...)X96cb5",
  "downloadUrl": "https://storage.googleapis.com/moises/939b7898b3ef?(...)SSScb5"
}

Jobs

Submit or retrieve a processing job from our servers.

Job Status Types

Every job has a status respresenting its current state:

Status	Description
QUEUED	Awaiting to start
STARTED	Processing has started
SUCCEEDED	Everything has completed and the resulst are ready
FAILED	There was an error processing your media

`GET /job/:id`

Example Request:

curl --request GET \
	--url https://developer-api.moises.ai/api/job/:id \
	--header 'Authorization: your-api-key-here'

Example Response:

{
  "id": "2e35babc-91c4-4121-89f4-5a2acf956b28",
  "name": "My job 123",
  "status": "SUCCEEDED",
  "workflow": {
    "id": "2ae5eea3-63dd-445e-9a3f-ff0473e82fd2",
    "name": "Stems Isolations - Vocals & accompaniments"
  },
  "workflowParams": {
    "inputUrl": "https://your-server.com/audio-input.m4a"
  },
  "result": {
    "vocals": "https://cdn.moises.ai/something/vocals.wav",
    "accompaniments": "https://cdn.moises.ai/something/accompaniments.wav"
  },
  "createdAt": "2022-12-07T19:21:42.170Z",
  "startedAt": "2022-12-07T19:21:42.307Z",
  "completedAt": "2022-12-07T19:22:00.325Z"
}

`GET /job`

Example Request:

curl --request GET \
	--url https://developer-api.moises.ai/api/job \
	--header 'Authorization: your-api-key-here'

Example Response:

[
  {
    "id": "2e35babc-91c4-4121-89f4-5a2acf956b28",
    "name": "My job 123",
    "status": "SUCCEEDED",
    "workflow": {
      "id": "2ae5eea3-63dd-445e-9a3f-ff0473e82fd2",
      "name": "Stems Isolations - Vocals & accompaniments"
    },
    "workflowParams": {
      "inputUrl": "https://your-server.com/audio-input.m4a"
    },
    "result": {
      "vocals": "https://cdn.moises.ai/something/vocals.wav",
      "accompaniments": "https://cdn.moises.ai/something/accompaniments.wav"
    },
    "createdAt": "2022-12-07T19:21:42.170Z",
    "startedAt": "2022-12-07T19:21:42.307Z",
    "completedAt": "2022-12-07T19:22:00.325Z"
  },
  // ...
]

`POST /job`

Example Request:

curl --request POST \
	--url https://developer-api.moises.ai/api/job \
	--header 'Authorization: your-api-key-here' \
	--header 'Content-Type: application/json' \
	--data '{
    "name": "My job 123",
    "workflow": "my-workflow-id",
    "params": {
      "inputUrl": "https://your-server.com/some-audio.m4a"
    }
  }'

Example Response:

{
  "id": "2e35babc-91c4-4121-89f4-5a2acf956b28"
}

`DELETE /job/:id`

Example Request:

curl --request DELETE \
	--url https://developer-api.moises.ai/api/job/:id \
	--header 'Authorization: your-api-key-here'

Example Response:

{
  "id": "2e35babc-91c4-4121-89f4-5a2acf956b28"
}

Application

Check the information about the current used apiKey/application

`GET /application`

Example Request:

curl --request GET \
	--url https://developer-api.moises.ai/api/application \
	--header 'Authorization: your-api-key-here'

Example Response:

{
  "id": "80b069ab-8410-4cc9-9bfa-1282b97dc1df",
  "name": "Default Application"
}