Model Context Protocol • OpenAPI • REST

Kết Nối OlokaTTS Với AI Agents

Tích hợp engine tạo giọng nói tiếng Việt chuẩn phòng thu 48kHz trực tiếp vào ChatGPT, Claude Desktop, Cursor, Antigravity và bất kỳ ứng dụng nào của bạn.

hub

Gateway Public URL Online

https://phucsd-vieneu-gateway.hf.space

code Xem openapi.json

Tích Hợp Vào ChatGPT (Custom GPT Actions)

ChatGPT kết nối với OlokaTTS thông qua giao thức tiêu chuẩn OpenAPI Actions. Sau khi kết nối, bạn chỉ cần chat với GPT là bot có thể tự sinh giọng nói ngay trong cửa sổ chat!

Tạo GPT & Mở Cấu Hình

Vào Explore GPTs > Create a GPT, chuyển sang tab Cấu hình (Configure).

Cuộn Xuống "Hành Động"

Lăn chuột xuống dưới cùng của cột bên trái (dưới mục Tính năng), bấm nút Tạo hành động mới (Create new action).

Nhập URL OpenAPI Hoặc Dán Schema

Bấm nút Nhập từ URL rồi dán link OpenAPI, hoặc dán đoạn mã Schema có sẵn bên dưới.

bolt Cách Nhanh Nhất: Bấm "Nhập từ URL" (Import from URL)

Hoặc Dán Đoạn Schema Này Vào Ô Schema:

openapi: 3.1.0
info:
  title: OlokaTTS Voice Generator
  description: High-fidelity 48kHz Vietnamese Neural Speech Engine powered by Kaggle Tesla T4.
  version: 1.0.0
servers:
  - url: https://phucsd-vieneu-gateway.hf.space
paths:
  /v1/audio/speech:
    post:
      operationId: generateSpeech
      summary: Synthesize Vietnamese text to 48kHz audio speech
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - input
              properties:
                model:
                  type: string
                  default: "olokatts-v3-turbo"
                input:
                  type: string
                  description: "Nội dung tiếng Việt cần đọc, có thể chèn [cười], [thở dài], [0.5s]"
                voice:
                  type: string
                  default: "Hải Đăng"
                  description: "Tên giọng đọc (ví dụ: Hải Đăng, Mai Anh, Anh Khôi, Trúc Ly, Quang Sơn)"
                speed:
                  type: number
                  default: 1.0
      responses:
        "200":
          description: Audio WAV stream
          content:
            audio/wav:
              schema:
                type: string
                format: binary

Hướng Dẫn (Instructions) Điền Cho GPT:

Bạn là trợ lý lồng tiếng và đọc văn bản tiếng Việt chuyên nghiệp OlokaTTS.
Khi người dùng yêu cầu đọc văn bản hoặc chuyển đổi thành giọng nói:
1. Tự động chọn một giọng đọc phù hợp (hoặc hỏi người dùng):
   - 'Hải Đăng' (Nam miền Nam, tự nhiên, hiện đại - Mặc định)
   - 'Mai Anh' (Nữ miền Bắc, giọng đọc phát thanh viên tin tức)
   - 'Anh Khôi' (Nam miền Bắc, truyền cảm, trầm ấm kể chuyện)
   - 'Quang Sơn' (Nam miền Trung, chân thực, sâu lắng)
   - 'Trúc Ly' (Nữ miền Bắc, trong trẻo, thu hút)
2. Bạn có thể tự nhiên thêm các thẻ cảm xúc như [cười], [thở dài], [thì thầm], [0.5s] vào câu đọc để âm thanh giàu sắc thái biểu cảm.
3. Gọi hành động (action) `generateSpeech` với văn bản và giọng đọc đã chọn.

Chi Tiết MCP Tools & Thẻ Cảm Xúc (Emotion Tags)

Các công cụ và thẻ điều khiển giọng đọc mà các AI Agent có thể sử dụng khi tương tác với OlokaTTS.

Tên Hàm (MCP Tool)	Tham Số Chính	Mô Tả & Kết Quả
generate_speech	prompt, voice, speed, output_path	Tạo file âm thanh 48kHz WAV, tải về máy cục bộ, hỗ trợ biểu cảm.
list_voices	region, gender, editors_pick_only	Tra cứu danh sách 25 giọng đọc theo vùng miền (Bắc/Trung/Nam) và giới tính.
get_system_status	không	Kiểm tra trạng thái GPU Worker Kaggle Dual Tesla T4 và hàng đợi.
estimate_speech_duration	text, speed	Ước tính số từ, số ký tự và thời lượng phát thanh dự kiến.

Thẻ Cảm Xúc Biểu Cảm (Emotion Tags)

[cười]

Tiếng cười nhẹ, vui vẻ

[thở dài]

Thở dài, sâu lắng, buồn

[thì thầm]

Giọng nói thì thầm bí mật

[0.5s]

Chèn khoảng lặng ngắt nghỉ

[hắng giọng]

Hắng giọng trước khi nói

[ngập ngừng]

Do dự, ngập ngừng

[hét lên]

Hét lớn, cao giọng gay gắt

[1.0s]

Khoảng lặng kịch tính dài

check_circle Đã sao chép vào bộ nhớ tạm!