Migration Guide

👍

API.audio is now AudioStack.

We will deprecate its predecessor API.audio over the course of 2023. In the meantime, it's in maintenance mode, which means that there won't be any more features rolled out.

If you are still running API.audio and need support, please visit the legacy documentation.

Here is how Migration works:

1. Go to Audiostack.ai and register. You can use the same email you used on API.audio. If you have received an enterprise access code use it when registering.
2. Log in to your account, go to Billing and choose your plan. Add your payment details to confirm
3. Read the migration guide as well as overall AudioStack documentation here
4. Change your existing code base using the AudioStack code
5. Test
6. Deploy

That's it. If you have any questions about migration please contact us at [email protected]

Why Use AudioStack?:

AudioStack is faster, more robust, easier to code and a lot more powerful. Here are the changes in a nutshell:

General changes

Script

❗️

ScriptId is no longer assignable

In v1 you'd be able to assign scriptId into speech. Now in v2 scriptId in script POST is no longer assignable. This is one of the BIGGEST changes to your workflow.

/script endpoint now migrated to /content/script
Script post method now creates new asset
ScriptId field in script (POST) no longer assignable.
Script (UPDATE) method is now available

Speech

/speech endpoint now migrated to /speech/tts
List (GET) method added in speech/tts endpoint
Delete (DELETE) method added in speech/tts endpoint
URLs returned from speech are now permanent.
Use public=True in speech/tts (POST) method to return a publicly sharable url.

Mastering

/mastering endpoint now migrated to /production/mix
List (GET) method added in /production/mix endpoint
Delete (DELETE) method added in /production/mix endpoint
URLs returned from mixing are now permanent.
Use public=True in /production/mix (POST) method to return a publicly sharable url.
endFormat, connectors, vast are now deprecated fields
ScriptId is no longer sent to the /production/mix endpoint, instead send a speechId (return from /speech/tts (POST) request.

Delivery

/delivery/encoder endpoint is now used to convert produced assets into different audio formats. i.e. mp3.
/delivery/encoder endpoint takes a productionId as its input field.

 Media

/media/* endpoints are now migrated to /content/media/*
/create-upload-url is now a POST method (as opposed to GET)

 Diction

/diction/* endpoints are now migrated to /speech/diction/*

 Sound

/sound/template/* endpoints are now migrated to /production/sound/template/*

Voice

/voice/* endpoints are now migrated to /speech/voice/*