List available voices

​

Endpoint

​

Request parameters

• limit string optional
  Page size. Default 20, min 1, max 100.
• order string optional
  Sort order by creation time, asc or desc (default).
  asc: older voices first
  desc: newer voices first
• before string optional
  Cursor voice ID; can be combined with limit / order.
• after string optional
  Cursor voice ID; can be combined with limit / order.

​

Response

• object string
  Always list.
• data array
  Voice entries:
  • id int
    Voice ID for audio generation.
  • file_id int
    Source audio File ID used for cloning.
  • created_at int
    Creation time.
• has_more boolean
  Whether more pages exist.
• first_id string
  ID of the first voice in the page.
• last_id string
  ID of the last voice in the page.

​

Example

curl --location 'https://api.stepfun.ai/v1/audio/voices' \
--header 'Authorization: Bearer YOUR_STEPFUN_TOKEN'

import requests

url = "https://api.stepfun.ai/v1/audio/voices"

payload = {}
headers = {
'Authorization': 'Bearer STEPFUN_API_TOKEN'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

{
    "object": "list",
    "data": [
        {
            "id": "voice-tone-FmBrMBqicC",
            "file_id": "file-FmBrMBqicC",
            "created_at": 1742374363
        }
    ],
    "has_more": false,
    "first_id": "voice-tone-FmBrMBqicC",
    "last_id": "voice-tone-FmBrMBqicC"
}