Tài liệu API

Từ nói sang văn bảnName

Phiên âm âm thanh thành văn bản. Hỗ trợ 99 ngôn ngữ với tự động phát hiện.

Cơ thể yêu cầu (multipart/form-data)

Phản hồi

{
  "text": "Hello, this is a transcription test.",
  "language": "en",
  "duration": 3.5,
  "segments": [
    {
      "start": 0.0,
      "end": 1.8,
      "text": "Hello, this is",
      "speaker": "SPEAKER_00"
    },
    {
      "start": 1.8,
      "end": 3.5,
      "text": "a transcription test.",
      "speaker": "SPEAKER_00"
    }
  ]
}

Bản sao giọng

Tạo giọng nói bằng giọng nhân bản. Tải lên âm thanh và văn bản tham khảo.

Cơ thể yêu cầu (multipart/form-data)

Phản hồi

Trả về tập tin âm thanh dưới dạng dữ liệu nhị phân, giống như điểm kết thúc TTS.

Bộ thay đổi giọng nóiName

Chuyển đổi âm thanh thành giọng nói khác. Tải lên âm thanh nguồn và chọn giọng nói mục tiêu.

Cơ thể yêu cầu (multipart/form-data)

Yêu cầu ví dụ

curl -X POST https://api.tts.ai/v1/voice-convert/ \
  -H "Authorization: Bearer sk-tts-your-key" \
  -F "file=@source_audio.mp3" \
  -F "target_voice=af_bella" \
  -F "model=openvoice" \
  -o converted.wav

Phản hồi

Trả về tập tin âm thanh đã chuyển đổi dưới dạng dữ liệu nhị phân.

Dịch Giọng nóiName

Dịch âm thanh nói từ ngôn ngữ này sang ngôn ngữ khác. Gộp lại giọng nói thành văn bản, dịch, và văn bản thành giọng nói trong một cuộc gọi duy nhất. Name

Cơ thể yêu cầu (multipart/form-data)

Phản hồi

{
  "original_text": "Hello, how are you?",
  "translated_text": "Hola, como estas?",
  "source_language": "en",
  "target_language": "es",
  "audio_url": "https://api.tts.ai/v1/results/translate_abc123.mp3",
  "credits_used": 5
}

Giọng nói sang giọng nói

Thay đổi phong cách nói, cảm xúc, hay trình bày trong khi giữ nội dung. Có ích cho điều chỉnh giọng, nhịp điệu, và sự biểu cảm.

Cơ thể yêu cầu (multipart/form-data)

Phản hồi

Trả về tập tin âm thanh đã biến đổi thành dữ liệu nhị phân.

Công cụ âm thanhName

Điểm kết thúc xử lý âm thanh để tăng cường, loại bỏ giọng nói, chia cắt thân, và nhiều hơn nữa.

{
  "key": "C",
  "scale": "Major",
  "bpm": 120.0,
  "time_signature": "4/4",
  "camelot": "8B",
  "compatible_keys": ["C Major", "G Major", "F Major", "A Minor"]
}

Thảo luận bằng giọng nói

Gửi âm thanh hoặc văn bản và nhận một phản hồi AI với giọng nói tổng hợp.

Cơ thể yêu cầu (multipart/form-data hoặc JSON)

Phản hồi

{
  "conversation_id": "conv_abc123",
  "user_text": "What is the capital of France?",
  "ai_text": "The capital of France is Paris.",
  "audio_url": "https://api.tts.ai/v1/audio/tmp/resp_xyz.mp3",
  "credits_used": 3
}

TTS theo lô

Gửi nhiều văn bản để tạo TTS song song. Có thể nhận một cuộc gọi webhook khi tất cả các công việc hoàn thành.

Tham số

Phản hồi

{
  "batch_id": "abc123",
  "total": 3,
  "completed": 0,
  "status": "processing"
}

Thực hiện cuộc thăm dò với GET /v1/tts/batch/result/?batch_id=abc123

Tạo giọng nói

Đoán trước một giọng nói nhúng từ âm thanh tham chiếu. Dùng embed_id trả về trong các yêu cầu nhân bản giọng nói tiếp theo để tạo gần như ngay lập tức.

Tham số

Phản hồi

{
  "embed_id": "emb_abc123",
  "model": "chatterbox",
  "duration_ms": 450
}

Kiểm tra sức khỏe

Kiểm tra trạng thái máy chủ GPU, các mô hình đã tải, và kích thước hàng đợi. Không cần xác thực. Bộ nhớ tạm trong 30 giây.

Phản hồi

{
  "status": "online",
  "latency_ms": 45,
  "queue_size": 3,
  "models_loaded": ["kokoro", "chatterbox", "cosyvoice2"]
}

Danh sách mẫu

Trả lại danh sách tất cả các mô hình có sẵn với khả năng của chúng.

Phản hồi

{
  "models": [
    {
      "id": "kokoro",
      "name": "Kokoro",
      "type": "tts",
      "tier": "standard",
      "languages": ["en", "ja", "ko", "zh", "fr"],
      "supports_cloning": false,
      "supports_streaming": true,
      "credits_per_1k_chars": 2
    },
    {
      "id": "chatterbox",
      "name": "Chatterbox",
      "type": "tts",
      "tier": "premium",
      "languages": ["en"],
      "supports_cloning": true,
      "supports_streaming": true,
      "credits_per_1k_chars": 4
    }
  ]
}

Danh sách âm thanh

Trả lại danh sách tất cả giọng nói sẵn có, có thể lọc theo mẫu hoặc ngôn ngữ.

Tham số truy vấn

Phản hồi

{
  "voices": [
    {
      "id": "af_bella",
      "name": "Bella",
      "model": "kokoro",
      "language": "en",
      "gender": "female",
      "preview_url": "https://api.tts.ai/v1/voices/preview/af_bella.mp3"
    }
  ],
  "total": 142
}

Bộ phụ đề (SRT / VTT) mới

Tạo phụ đề đồng bộ cho bất kỳ công việc TTS nào đã hoàn thành. Chạy điều chỉnh Whisper trên âm thanh và trả về SRT hoặc WebVTT. Kết quả được lưu trữ tạm trên đĩa, vì vậy một cuộc gọi thứ hai cho cùng một uuid là một đọc đĩa.

Tham số truy vấn

curl "https://api.tts.ai/v1/speech/subtitles/?uuid=$UUID&format=srt&download=1" -o subtitles.srt

Từ điển phát âm mới

Cho bộ máy TTS biết cách phát âm các từ cụ thể. Các mục đã lưu sẽ tự động áp dụng cho mỗi yêu cầu TTS bạn thực hiện. Giới hạn 200 mục trên mỗi tài khoản.

Cơ thể yêu cầu (POST)

# Save an entry
curl -X POST https://tts.ai/api/v1/pronunciations/ \
  -H "Authorization: Bearer sk-tts-..." \
  -H "Content-Type: application/json" \
  -d '{"word": "GIF", "replacement": "jiff"}'

# List your entries
curl https://tts.ai/api/v1/pronunciations/ -H "Authorization: Bearer sk-tts-..."

# Delete entry by id
curl -X DELETE "https://tts.ai/api/v1/pronunciations/?id=42" -H "Authorization: Bearer sk-tts-..."

Bạn cũng có thể truyền các thay thế theo yêu cầu mà không cần lưu chúng — bao gồm pronunciations trên bất kỳ cuộc gọi /v1/tts/ nào như một đối tượng hoặc một ma trận (xem các tham số điểm cuối TTS).

Trình kể chuyện bài viết mới

Đặt một thẻ