sangtao.ai
API key

Assets & References

Voices

The voices you can use for AI voiceover — 30 credits per 1,000 characters, every voice.

GEThttps://api.sangtao.ai/v2/assets/voices

Authorization

None — this endpoint is public, call it without an API key.

The voices you can use, in English and Vietnamese. Send a voice's id as voiceId when creating a video. No API key needed.

Query parameters

  • languagestring

    Only voices that can read this language (e.g. "vi", "en"), voices native to it first. Many voices read several languages — see languages.

  • genderstring

    Only voices of this gender (case does not matter)

    Available options:malefemale

Response

data is a list of voices, each with these fields:

  • idstring

    The voice's id, e.g. "el-adam" — send it as voiceId when creating a video

  • namestring

    Display name

  • languagestring

    The voice's own language, e.g. "vi", "en"

  • languagesstring[]

    Every language the voice can read, its own first

  • genderstring?

    Voice gender

    Available options:malefemaleneutral

  • agestring?

    Age group

    Available options:youngmiddleagedold

  • accentstring?

    Accent, e.g. "american", "british" for English, "northern", "central", "southern" for Vietnamese

  • useCasestring?

    What the voice suits best, e.g. "narrative_story", "social_media", "conversational", "advertisement"

  • descriptionstring?

    A short description, in Vietnamese

  • previewUrlstring?

    A short sample to listen to (mp3); null for a few voices

  • creditCostPer1kCharsnumber

    Credits per 1,000 characters read — 30 for every voice

Pricing

Every voice costs the same: 30 credits per 1,000 characters.

Errors

StatuserrorCodeWhen
400VALIDATION_ERRORA query parameter has a value it does not take — error says which
GET/assets/voices
curl "https://api.sangtao.ai/v2/assets/voices"
{
  "success": true,
  "data": [
    {
      "id": "el-adam",
      "name": "Adam",
      "language": "en",
      "languages": [
        "en"
      ],
      "gender": "male",
      "age": "middleaged",
      "accent": "american",
      "useCase": "social_media",
      "description": "Nam · Trung niên · giọng american · 1 ngôn ngữ",
      "previewUrl": "https://cdn.sangtao.ai/motion/system/voices/21f3658ec490b2a69e9d610292954dd3.mp3",
      "creditCostPer1kChars": 30
    },
    {
      "id": "el-an-nhien",
      "name": "An Nhiên",
      "language": "vi",
      "languages": [
        "vi"
      ],
      "gender": "female",
      "age": "young",
      "accent": "southern",
      "useCase": "entertainment_tv",
      "description": "Nữ · Trẻ · giọng Nam · Giải trí / TV",
      "previewUrl": "https://cdn.sangtao.ai/motion/system/voices/09f381132574da1bfe36c5481b6cbf7b.mp3",
      "creditCostPer1kChars": 30
    }
  ]
}