Fetch Audio Result - Stability AI API Platform

import requests

generation_id = "e52772ac75b..."
result = requests.get(
    f"https://api.stability.ai/v2beta/audio/results/{generation_id}",
    headers={"authorization": f"Bearer sk-MYAPIKEY", "accept": "audio/*"},
)

if result.status_code == 202:
    print("Generation is still in-progress.")
elif result.status_code == 200:
    with open("./output.mp3", "wb") as f:
        f.write(result.content)
    print("Download complete!")
else:
    raise Exception(str(result.json()))

"The bytes of the generated mpeg"

{
  "id": "a6dc6c6e20acda010fe14d71f180658f2896ed9b4ec25aa99a6ff06c796987c4",
  "status": "in-progress"
}

{
  "id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
  "name": "bad_request",
  "errors": [
    "some-field: is required"
  ]
}

{
  "id": "2bca35116bc5431d6dc4b4ea2ef3da2f",
  "name": "generation_not_found",
  "errors": [
    "id: the generation either does not exist or has expired."
  ]
}

{
  "id": "2a1b2d4eafe2bc6ab4cd4d5c6133f513",
  "name": "internal_error",
  "errors": [
    "An unexpected server error has occurred, please try again later."
  ]
}

GET

/

v2beta

/

audio

/

results

/

{id}

import requests

generation_id = "e52772ac75b..."
result = requests.get(
    f"https://api.stability.ai/v2beta/audio/results/{generation_id}",
    headers={"authorization": f"Bearer sk-MYAPIKEY", "accept": "audio/*"},
)

if result.status_code == 202:
    print("Generation is still in-progress.")
elif result.status_code == 200:
    with open("./output.mp3", "wb") as f:
        f.write(result.content)
    print("Download complete!")
else:
    raise Exception(str(result.json()))

"The bytes of the generated mpeg"

{
  "id": "a6dc6c6e20acda010fe14d71f180658f2896ed9b4ec25aa99a6ff06c796987c4",
  "status": "in-progress"
}

{
  "id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
  "name": "bad_request",
  "errors": [
    "some-field: is required"
  ]
}

{
  "id": "2bca35116bc5431d6dc4b4ea2ef3da2f",
  "name": "generation_not_found",
  "errors": [
    "id: the generation either does not exist or has expired."
  ]
}

{
  "id": "2a1b2d4eafe2bc6ab4cd4d5c6133f513",
  "name": "internal_error",
  "errors": [
    "An unexpected server error has occurred, please try again later."
  ]
}

Authorizations

authorization

string

header

required

Use your Stability API key to authentication requests to this App.

Headers

authorization

string

required

Your Stability API key, used to authenticate your requests. Although you may have multiple keys in your account, you should use the same key for all requests to this API.

Minimum string length: 1

accept

enum<string>

default:audio/*

Specify audio/* to receive the bytes of the audio directly. Otherwise specify application/json to receive the audio as base64 encoded JSON.

Available options:

audio/*,

application/json

stability-client-id

string

The name of your application, used to help us communicate app-specific debugging or moderation issues to you.

Maximum string length: 256

Example:

"my-awesome-app"

stability-client-user-id

string

A unique identifier for your end user. Used to help us communicate user-specific debugging or moderation issues to you. Feel free to obfuscate this value to protect user privacy.

Maximum string length: 256

Example:

"DiscordUser#9999"

stability-client-version

string

The version of your application, used to help us communicate version-specific debugging or moderation issues to you.

Maximum string length: 256

Example:

"1.2.1"

Path Parameters

id

string

required

The id of a generation, typically used for async generations, that can be used to check the status of the generation or retrieve the result.

Required string length: 64

Example:

"a6dc6c6e20acda010fe14d71f180658f2896ed9b4ec25aa99a6ff06c796987c4"

Response

Generation was successful.

The bytes of the generated audio.

The finish-reason and seed will be present as headers.