URL gốc API TTS: Là gì và Nhập gì

URL gốc, và một điều cần biết trước

Nếu bạn đến đây bằng cách tìm kiếm tts api base url, hãy kiểm tra một chi tiết trước khi sao chép bất cứ thứ gì: dịch vụ đằng sau trang web này là API mô hình ngôn ngữ văn bản, không phải bộ tổng hợp giọng nói. URL gốc là https://api.ttsapihub.com/v1, và nó cung cấp POST /v1/chat/completions và GET /v1/models. Không có tuyến /audio/speech, không có danh sách giọng nói và không có đầu ra âm thanh.

Điều này quan trọng vì nhiều công cụ gắn nhãn cài đặt của chúng một cách chung chung. Một trường có tên là URL gốc trong một client hoạt động theo cách tương tự bất kể máy chủ phía sau trả về văn bản hay âm thanh. Nếu mục tiêu của bạn là chuyển văn bản thành âm thanh, endpoint này sẽ không làm được điều đó. Nếu mục tiêu của bạn là tạo ra văn bản mà một công cụ giọng nói sẽ đọc sau đó, cho các kịch bản, hội thoại hoặc bản nháp kể chuyện, nó phù hợp. Danh sách kiểm tra quy trình TTS của trang web là nơi bạn nên xem xét khi lên kế hoạch cho quy trình làm việc đó, và tài liệu bắt đầu nhanh liệt kê mọi tham số yêu cầu.

Phần còn lại của trang này áp dụng cho bất kỳ máy khách tương thích OpenAI nào, vì vậy nó hữu ích ngay cả khi bạn chỉ ở đây để tìm hiểu cách URL gốc hoạt động.

URL gốc thực sự là gì

Địa chỉ API có hai nửa. Nửa đầu xác định dịch vụ và phiên bản giao diện của nó. Nửa sau đặt tên cho hành động. Thư viện máy khách ghép chúng lại cho bạn. Với các SDK OpenAI, các mảnh trông như thế này:

Phần	Giá trị
URL gốc	https://api.ttsapihub.com/v1
Đường dẫn được SDK thêm cho trò chuyện	/chat/completions
Địa chỉ đầy đủ được gọi	https://api.ttsapihub.com/v1/chat/completions
Đường dẫn cho danh sách mô hình	/models

Vì SDK thêm đường dẫn, bạn chỉ cung cấp cho nó nửa đầu. Đó là toàn bộ ý tưởng đằng sau việc chuyển nhà cung cấp với một thay đổi một dòng: định dạng yêu cầu được chia sẻ, vì vậy điều duy nhất phải di chuyển là nơi yêu cầu được gửi. Khóa cũng thay đổi, vì mỗi dịch vụ cấp khóa của riêng mình. Và tên mô hình thay đổi, vì mỗi dịch vụ đặt tên cho các mô hình của riêng mình. Đối với API này, ID mô hình là uncensored.

Hai chi tiết nhỏ tiết kiệm thời gian. Phần phiên bản, /v1, thuộc về URL gốc vì nó đánh dấu phiên bản giao diện; một giao diện không tương thích trong tương lai sẽ sống dưới một phiên bản khác, và mã của bạn sẽ không thay đổi cho đến khi bạn chọn di chuyển. Và dấu gạch chéo cuối cùng trên URL gốc được hầu hết các SDK chấp nhận, nhưng an toàn hơn là bỏ nó đi để các đường dẫn nối không bao giờ chứa dấu gạch chéo kép.

Xác thực là tiêu đề bearer tiêu chuẩn: Authorization: Bearer YOUR_KEY. SDK xây dựng tiêu đề đó từ khóa bạn chuyển vào, vì vậy bạn hiếm khi tự viết nó ngoài trừ trong curl.

Đặt URL gốc trong mã

Python

Gói openai chính thức lấy đối số base_url. Đây là một gọi hàm hoàn chỉnh:

Copyfrom openai import OpenAI

client = OpenAI(
    base_url="https://api.ttsapihub.com/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write a two-line scene opening."}],
)
print(resp.choices[0].message.content)

Node

Copyimport OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.ttsapihub.com/v1",
  apiKey: process.env.API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a two-line scene opening." }],
});
console.log(resp.choices[0].message.content);

curl

Với curl, bạn tự viết địa chỉ đầy đủ, vì vậy đường dẫn được bao gồm:

Copycurl https://api.ttsapihub.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "messages": [{"role": "user", "content": "Say hello."}]}'

Biến môi trường

Các phiên bản mới nhất của SDK OpenAI chính thức đọc OPENAI_BASE_URL và OPENAI_API_KEY từ môi trường khi bạn không chuyển chúng trong mã. Điều đó hữu ích khi bạn muốn chỉ phần mềm hiện có đến một endpoint mới mà không cần chỉnh sửa nó. Đặt chúng trong shell hoặc bộ quản lý quy trình của bạn, sau đó chạy chương trình như bình thường. Kiểm tra tài liệu phiên bản SDK của bạn nếu nó không đọc chúng.

Đặt nó trong trình soạn thảo và ứng dụng

Các công cụ chấp nhận endpoint OpenAI tùy chỉnh yêu cầu cùng ba giá trị. Tên khác nhau, vì vậy hãy tìm các từ như sau:

• Cursor: trong cài đặt mô hình có tùy chọn ghi đè URL gốc OpenAI. Dán https://api.ttsapihub.com/v1, thêm khóa của bạn và thêm uncensored làm tên mô hình tùy chỉnh. Nhãn giao diện thay đổi giữa các phiên bản Cursor, vì vậy hãy coi những tên này là hướng dẫn.
• SillyTavern: chọn Chat Completion, sau đó nguồn Tùy chỉnh (tương thích OpenAI), và điền vào endpoint, khóa và mô hình.
• Open WebUI và các giao diện trò chuyện tương tự: thêm kết nối kiểu OpenAI với URL gốc và khóa.
• Script của riêng bạn: bất kỳ trình khách HTTP nào cũng hoạt động, vì giao diện là JSON thuần qua HTTPS.

Một số công cụ kiểm tra kết nối bằng cách gọi GET /v1/models. API này hỗ trợ đường dẫn đó, vì vậy kiểm tra thành công. Một vài công cụ chỉ cho phép bạn chọn từ một danh sách cố định; nếu công cụ của bạn làm vậy, hãy tìm trường mô hình tùy chỉnh hoặc thủ công thay vì danh sách thả xuống.

Nhớ lại công cụ dành cho mục đích gì. Một trình soạn thảo như Cursor sẽ gửi câu hỏi mã đến mô hình trò chuyện chung, điều đó hoạt động. Nhưng các tính năng phụ thuộc vào các endpoint đặc biệt, như embedding để tìm kiếm mã, không có sẵn ở đây, vì embedding không được cung cấp.

Các lỗi gây ra hầu hết các lỗi URL gốc

Hầu hết các kết nối đầu tiên thất bại đều đến từ một trong những điều này.

1. Nhân đôi phiên bản. URL gốc đã kết thúc bằng /v1. Nếu bạn thêm một cái khác, địa chỉ sẽ trở thành /v1/v1/chat/completions và máy chủ trả về lỗi không tìm thấy.
2. Dán đường dẫn đầy đủ. Trường URL gốc muốn https://api.ttsapihub.com/v1, không phải https://api.ttsapihub.com/v1/chat/completions. SDK sẽ thêm đường dẫn một lần nữa.
3. Sử dụng địa chỉ trang web. Trang bạn đọc không phải là máy chủ API. Yêu cầu được gửi đến máy chủ api. được hiển thị ở trên.
4. Gọi một endpoint giọng nói. Các đường dẫn như /audio/speech không tồn tại ở đây và trả về lỗi.
5. Tên mô hình sai hoặc thiếu. Luôn gửi uncensored bằng chữ thường.
6. Vấn đề về khóa. Một khoảng trắng lạc hoặc thiếu tiền tố Bearer trong tiêu đề viết tay gây ra lỗi xác thực.

Để phân biệt vấn đề URL với vấn đề khóa, hãy yêu cầu danh sách mô hình. URL đúng và khóa sai gây ra lỗi xác thực. URL sai gây ra không tìm thấy, lỗi DNS hoặc trang HTML thay vì JSON.

Copycurl https://api.ttsapihub.com/v1/models -H "Authorization: Bearer $API_KEY"
# then a minimal chat call with the model ID "uncensored":
curl https://api.ttsapihub.com/v1/chat/completions -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":5}'

Lấy khóa và chi phí của nó

Bạn cần một khóa API trước khi bất cứ điều gì trong số này hoạt động. Đăng ký với Google hoặc với email và mật khẩu trên trang tạo khóa API, sau đó nhận tín dụng dùng thử $0.50 chỉ với một cú nhấp chuột. Nó có giá trị trong 7 ngày, mỗi người chỉ được nhận một lần và không cần thẻ. Khóa dùng thử cho phép 2 yêu cầu đồng thời và 60 yêu cầu mỗi phút, trong khi khóa đầy đủ cho phép 8 yêu cầu đồng thời và 300 yêu cầu mỗi phút.

Giá là $0.15 cho mỗi 1M token đầu vào và $0.50 cho mỗi 1M token đầu ra, được thanh toán từ tín dụng trả trước không có đăng ký. Một yêu cầu với 2.000 token đầu vào và 500 token đầu ra tốn $0.0003 cộng $0.00025, vậy $0.00055. Nạp tiền chạy từ $20 đến $500 với tiền thưởng từ $50, và bạn có thể thanh toán bằng thẻ (Visa, Mastercard, Apple Pay, Google Pay) hoặc tiền mã hóa (USDT trên TRC20, USDC trên Base). trang giá cả có bảng đầy đủ. Prompt không được sử dụng để huấn luyện, và mô hình chỉ dành cho người trưởng thành sử dụng hợp pháp, không có nội dung tình dục liên quan đến người chưa thành niên.

Hướng dẫn khác

• API miễn phí cho SillyTavern: Tín dụng dùng thử và thiết lập
• Khóa API TTS trong Python: Thiết lập, truyền phát, chế độ JSON
• Danh sách kiểm tra API Elevenlabs: Đường dẫn TTS không kiểm duyệt