sangtao.ai
API key

Tài nguyên

Giọng đọc

Các giọng đọc AI dùng được — mọi giọng 30 credit / 1.000 ký tự.

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

Xác thực

Không cần — endpoint này công khai, gọi không cần API key.

Các giọng đọc dùng được, tiếng Anh và tiếng Việt. Gửi id của giọng làm voiceId khi tạo video. Không cần API key.

Tham số query

  • languagestring

    Chỉ giọng đọc được ngôn ngữ này (VD: "vi", "en"), giọng bản ngữ xếp trước. Nhiều giọng đọc được nhiều ngôn ngữ — xem languages.

  • genderstring

    Chỉ giọng thuộc giới tính này (không phân biệt hoa thường)

    Giá trị có thể:malefemale

Response

data là danh sách giọng, mỗi giọng gồm các field sau:

  • idstring

    ID của giọng, VD: "el-adam" — gửi làm voiceId khi tạo video

  • namestring

    Tên hiển thị

  • languagestring

    Ngôn ngữ gốc của giọng, VD: "vi", "en"

  • languagesstring[]

    Mọi ngôn ngữ giọng đọc được, ngôn ngữ gốc đứng đầu

  • genderstring?

    Giới tính giọng

    Giá trị có thể:malefemaleneutral

  • agestring?

    Nhóm tuổi

    Giá trị có thể:youngmiddleagedold

  • accentstring?

    Giọng vùng, VD: "american", "british" với tiếng Anh, "northern", "central", "southern" (Bắc, Trung, Nam) với tiếng Việt

  • useCasestring?

    Giọng hợp nhất với gì, VD: "narrative_story", "social_media", "conversational", "advertisement"

  • descriptionstring?

    Mô tả ngắn, bằng tiếng Việt

  • previewUrlstring?

    Đoạn nghe thử ngắn (mp3); vài giọng là null

  • creditCostPer1kCharsnumber

    Credit cho mỗi 1.000 ký tự đọc — mọi giọng đều là 30

Giá

Mọi giọng cùng một giá: 30 credit / 1.000 ký tự.

Mã lỗi

MãerrorCodeKhi nào
400VALIDATION_ERRORTham số query có giá trị không hợp lệ — error ghi rõ tham số nào
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
    }
  ]
}