Request Link to Upload Audio File

📘

Supported Regions and Base URLs

👍

Access and Registration

Authentication

Body Request - Example


{
  "validation_constraints": {
    "allowed_mime_types": [
      "audio/mp3",
      "audio/wav"
    ]
  }
}

Scope

prompts:write

Body Response - Schema

201 (the newly generated upload link and request ID)

ParameterTypeDescriptionRequired
idstringID that must be used as the request identifier (request_id) when creating the promptyes
_linksobjectHAL API-related links. "_links" subdivides into:

"upload_link" (string) - link used to upload the asset (available only when draft state)
yes

400 (validation constraint violation), 401 (unauthorized access - invalid or unverifiable JWT), 403 (forbidden)

ParameterTypeDescriptionRequired
codestringn/ayes
messagestringn/ayes
descriptionstringn/ano
fieldsarray[object]"fields" subdivides into:

"name" (string)

"description" (string)
yes (name and description)

🚧

Troubleshooting

If you have any questions regarding the usage of this API, or if you’re having any technical issues, please open a ticket using this form.

Language
Authorization
Header
Click Try It! to start a request and see the response here!