Skip to main content
Create a harmony

Authorizations

Authorization
string
header
required

Static API key issued by Audimee, passed as Authorization: Bearer {token}.

Body

application/json
inputFileUrl
string<uri>
required

http or https URL to the vocal to harmonize, at most 75 seconds long. The server downloads it server-side, so the URL must be reachable from the public internet for the duration of the request; URLs that resolve to private or internal addresses are rejected.

key
enum<string>
required

Musical key of the input. Harmony lines are built from the notes of this key, so a wrong key produces wrong-sounding harmonies.

Available options:
C Maj,
C Min,
C# Maj,
C# Min,
D Maj,
D Min,
D# Maj,
D# Min,
E Maj,
E Min,
F Maj,
F Min,
F# Maj,
F# Min,
G Maj,
G Min,
G# Maj,
G# Min,
A Maj,
A Min,
A# Maj,
A# Min,
B Maj,
B Min
presetId
string
required

id of the harmony preset to use, as returned by GET /harmony-presets — for example 1.

Response

Harmony created and its tracks queued for rendering. Poll GET /harmonies/{id} for progress.

id
string<uuid>
required

UUID of the queued harmony.