Hướng dẫn nhanh cho quy trình Xtts

Xác thực & Base URL

Bắt đầu bằng cách truy cập trang Lấy khóa API và đăng nhập bằng Google hoặc mật khẩu email. Bạn sẽ nhận được một khóa API duy nhất ngay lập tức. Sử dụng base URL https://api.xtts.cc/v1 cho tất cả các yêu cầu. URL này tương thích với các SDK chính thức của OpenAI và bất kỳ client nào hỗ trợ định dạng chat-completions của OpenAI.

Bao gồm khóa của bạn trong tiêu đề Authorization dưới dạng token bearer. Định danh mô hình bạn phải gửi là uncensored. Mô hình trọng số mở này được lưu trữ trên máy chủ của chúng tôi và được tinh chỉnh để trả lời mà không từ chối nội dung cho mục đích người lớn hợp pháp, đảm bảo quy trình giọng nói của bạn nhận được văn bản thô cần thiết.

Tạo văn bản không kiểm duyệt

Gửi yêu cầu POST đến /v1/chat/completions với prompt hệ thống và prompt người dùng của bạn. API trả về JSON có cấu trúc chứa văn bản đã tạo. Endpoint này được thiết kế cho việc viết prompt, tạo kịch bản và các nhiệm vụ xử lý hậu kỳ trong quy trình sao chép giọng nói của bạn.

Thân yêu cầu bao gồm tên mô hình, lịch sử tin nhắn của bạn và các tham số tùy chọn như temperature hoặc top_p. Bạn có thể kiểm soát độ dài đầu ra bằng tham số max_tokens. Nếu bạn không đặt max_tokens, phản hồi có thể chạy đến hết cửa sổ ngữ cảnh.

Sao chépcurl https://api.xtts.cc/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 Python SDK

Sử dụng Python SDK chính thức của OpenAI để tương tác với API của chúng tôi. Đặt base_url thành endpoint của chúng tôi và cung cấp khóa API của bạn. Cách tiếp cận này cho phép bạn tận dụng các cấu trúc mã hiện có trong khi hưởng lợi từ hành vi của mô hình không kiểm duyệt của chúng tôi.

Tạo một thể hiện client với base URL và sau đó gọi chat.completions.create. Truyền ID mô hình uncensored và các tin nhắn của bạn. Đối tượng phản hồi chứa văn bản đã tạo trong content. Phương pháp này lý tưởng cho các kịch bản xử lý hàng loạt hoặc tích hợp tạo văn bản vào các ứng dụng Python lớn hơn.

Sao chépfrom openai import OpenAI

client = OpenAI(base_url="https://api.xtts.cc/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 Node SDK

Đối với môi trường JavaScript, hãy sử dụng Node SDK của OpenAI. Cấu hình client với base URL và khóa API của chúng tôi. Cấu hình này cho phép bạn tạo văn bản trực tiếp trong các ứng dụng web hoặc phía máy chủ của bạn.

Gọi endpoint hoàn tất hội thoại với mô hình uncensored. Phản hồi cung cấp văn bản đã tạo, sau đó bạn có thể chuyển nó đến công cụ tổng hợp giọng nói của mình. Tích hợp này phù hợp cho việc tạo văn bản theo thời gian thực trong các ứng dụng web hoặc dịch vụ backend chuẩn bị kịch bản cho sao chép giọng nói.

Sao chépimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.xtts.cc/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 phát (Streaming)

Bật chế độ truyền phát bằng cách đặt stream thành 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) cho mỗi token được tạo. Tính năng này hữu ích cho việc hiển thị văn bản theo thời gian thực hoặc chuẩn bị tổng hợp giọng nói theo tiến trình.

Mỗi chunk sự kiện chứa văn bản một phần. Chunk cuối cùng bao gồm thống kê sử dụng, chẳng hạn như số lượng token. Truyền phát đảm bảo ứng dụng của bạn có thể xử lý văn bản khi nó được tạo, giảm độ trễ cảm nhận cho người dùng. Xử lý các sự kiện stream để tích lũy phản hồi hoàn chỉnh.

Sao chépstream = 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 tốc độ & Tham số

Mỗi khóa API bị giới hạn ở 300 yêu cầu mỗi phút và 8 yêu cầu đồng thời. Thân yêu cầu không được vượt quá 8 MB. Nếu bạn gửi khóa không hợp lệ, bạn sẽ nhận được lỗi 401. Nếu tín dụng trả trước của bạn đã cạn kiệt, bạn sẽ nhận được lỗi 402. Vượt quá giới hạn tốc độ sẽ dẫn đến lỗi 429.

Cửa sổ ngữ cảnh hỗ trợ tổng cộng 100.000 token, bao gồm cả prompt và phần hoàn tất. Không có giới hạn đầu ra riêng biệt, và bạn có thể chỉ định một max_tokens thấp hơn nếu muốn câu trả lời ngắn hơn. Lỗi và từ chối không tiêu tốn tín dụng trả trước của bạn. Hỗ trợ gọi hàm và chế độ JSON có sẵn để trích xuất dữ liệu có cấu trúc.