List cloned voices

​

Endpoint

​

Request parameters

• limit integer optional
  Page size. Default 20, min 1, max 100. A value outside this range returns 400.
• 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. Returns the page of voices that precede this ID in the current sort order.
• after string optional
  Cursor voice ID. Returns the page of voices that follow this ID in the current sort order.

​

Response

• object string
  Always list.
• data array
  Voice entries:
  • id string
    Voice ID for audio generation.
  • file_id string
    Source audio File ID used for cloning.
  • created_at integer
    Creation time, as a Unix timestamp in seconds.
• 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"
}

​

Pagination example

curl --location 'https://api.stepfun.ai/v1/audio/voices?limit=1&order=asc' \
  --header 'Authorization: Bearer YOUR_STEPFUN_TOKEN'

curl --location 'https://api.stepfun.ai/v1/audio/voices?limit=1&order=asc&after=voice-tone-FmBrMBqicC' \
  --header 'Authorization: Bearer YOUR_STEPFUN_TOKEN'