Hướng dẫn bắt đầu nhanh API TTS

URL cơ bản và Xác thực

Bắt đầu bằng cách cấu hình client của bạn trỏ đến URL cơ bản của chúng tôi: https://api.ttsapihub.com/v1. API của chúng tôi hoàn toàn tương thích OpenAI, vì vậy bạn có thể sử dụng các SDK tiêu chuẩn bằng cách chỉ cần cập nhật base_url và cung cấp khóa API của bạn. Xác thực được xử lý qua tiêu đề Authorization với token Bearer. Bạn tạo một khóa duy nhất trong quá trình đăng ký trên trang Lấy khóa API. Mỗi tài khoản chỉ giới hạn một khóa hoạt động, bạn có thể tạo lại khóa này bất cứ lúc nào. Các prompt của bạn không được sử dụng để huấn luyện, và không cần số điện thoại hay thẻ tín dụng để bắt đầu với tín dụng dùng thử.

Tạo văn bản với Hoàn thành Hội thoại

Gửi một yêu cầu POST /v1/chat/completions tiêu chuẩn để tạo văn bản. ID mô hình bạn cần sử dụng là uncensored. Đây là một mô hình LLM trọng số mở được tinh chỉnh để trả lời mà không từ chối nội dung cho mục đích người trưởng thành hợp pháp, rất lý tưởng cho các kịch bản sáng tạo hoặc hội thoại nơi bộ lọc doanh nghiệp có thể chặn nội dung của bạn. Mô hình không tạo ra âm thanh, hình ảnh hoặc video; nó xuất ra văn bản thuần túy để đường ống TTS của bạn xử lý. Bạn có thể điều chỉnh các tham số như temperature và max_tokens khi cần. API hỗ trợ gọi hàm để trích xuất dữ liệu có cấu trúc, cho phép bạn định dạng phản hồi cho ứng dụng của mình.

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": "Write a blunt product review of a cheap VPN."}]
  }'

Tích hợp SDK Python

Đối với nhà phát triển Python, SDK openai chính thức hoạt động ngay lập tức với cấu hình tối thiểu. Khởi tạo client với URL cơ bản và khóa API của bạn, sau đó gọi chat.completions.create(). Cách tiếp cận này cho phép bạn tận dụng các client tương thích OpenAI hiện có trong khi hưởng lợi từ mô hình không kiểm duyệt của chúng tôi. Phản hồi bao gồm văn bản đã tạo, bạn có thể đưa trực tiếp vào công cụ tổng hợp giọng nói của mình. Hãy nhớ rằng đây là API chỉ xử lý văn bản, vì vậy bạn xử lý tạo âm thanh riêng biệt trong pipeline của mì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": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Tích hợp SDK Node.js

Nhà phát triển Node.js có thể sử dụng gói npm openai với cùng cấu hình như Python. Đặt baseURL thành endpoint của chúng tôi và cung cấp khóa API của bạn. Gọi endpoint hoàn thành với ID mô hình uncensored. Tích hợp này rất đơn giản và cho phép bạn tích hợp trực tiếp việc tạo văn bản của chúng tôi vào các dịch vụ TTS Node.js hiện có của bạn. API phản hồi bằng JSON tiêu chuẩn, giúp dễ dàng phân tích cú pháp và xử lý văn bản đã tạo cho nhu cầu ứng dụng của bạn.

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: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Phản hồi truyền qua SSE

Để giảm độ trễ, hãy bật chế độ truyền bằng cách đặt stream: true trong yêu cầu của bạn. API trả về các Sự kiện do máy chủ gửi (SSE) chứa các đoạn văn bản tăng dần. Điều này đặc biệt hữu ích cho việc tạo nội dung dài, vì người dùng có thể thấy văn bản xuất hiện theo thời gian thực. Phản hồi truyền tuân theo định dạng SSE tiêu chuẩn của OpenAI, vì vậy bạn có thể sử dụng các trình phân tích cú pháp luồng hiện có. Cách tiếp cận này giảm thời gian chờ cảm nhận và cho phép ứng dụng của bạn hiển thị văn bản khi nó được tạo, cải thiện trải nghiệm người dùng cho pipeline TTS của bạn.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Giới hạn, Lỗi và Cửa sổ ngữ cảnh

Khóa API của bạn bị giới hạn ở 300 yêu cầu mỗi phút và thân yêu cầu tối đa 8 MB. Mô hình hỗ trợ cửa sổ ngữ cảnh 100,000 token, cho phép xử lý các kịch bản hoặc tài liệu dài. Các lỗi phổ biến bao gồm 401 (khóa không hợp lệ), 402 (tín dụng không đủ) và 429 (giới hạn tốc độ). Nếu bạn chạm giới hạn tốc độ, hãy triển khai cơ chế backoff theo cấp số nhân. Giá cả minh bạch: $0.25 cho mỗi 1M token đầu vào và $1.00 cho mỗi 1M token đầu ra. Tín dụng là tín dụng trả trước, không bao giờ hết hạn và các khoản nạp tiền bắt đầu từ $10. Tài khoản mới nhận $0.50 tín dụng dùng thử miễn phí có hiệu lực trong 7 ngày, không yêu cầu thẻ. Giới hạn nội dung chỉ chặn nội dung tình dục liên quan đến trẻ vị thành niên; tất cả các chủ đề hợp pháp khác dành cho người trưởng thành, hư cấu hoặc gây tranh cãi đều được cho phép.