Tài liệu API: Chat Completions cho Pipeline văn bản

URL cơ bản & Xác thực

Bắt đầu bằng cách trỏ client của bạn đến base URL https://api.speechtotextapis.com/v1. Endpoint này tương thích hoàn toàn với OpenAI, nghĩa là bạn có thể sử dụng bất kỳ SDK openai tiêu chuẩn nào chỉ bằng cách ghi đè tham số base_url. Bạn không cần viết lại logic yêu cầu; chỉ cần thay đổi URL và đưa khóa API của bạn vào. Khóa được tạo ngay khi đăng ký trên trang khóa. Khóa liên kết với tài khoản của bạn và bạn có thể tạo lại bất cứ lúc nào, khóa cũ sẽ bị thu hồi ngay lập tức. Không yêu cầu số điện thoại và tín dụng dùng thử kích hoạt mà không cần thẻ. Cấu hình này giữ cho pipeline của bạn đơn giản trong khi đảm bảo bạn có quyền truy cập vào một mô hình không kiểm duyệt xử lý nội dung người lớn hợp pháp mà không làm mềm đầu ra.

Yêu cầu đầu tiên

Gửi yêu cầu POST tiêu chuẩn đến /v1/chat/completions. Định danh mô hình luôn là uncensored. Mô hình này là biến thể trọng số mở được tinh chỉnh để từ chối tối thiểu đối với các chủ đề hợp pháp. Nó chạy trên các máy chủ GPU chuyên dụng của chúng tôi. Bạn không nhận được GPT hay Claude; bạn nhận được trải nghiệm mô hình đơn nhất, ổn định. Thân yêu cầu bao gồm các cờ model, messages và stream. Dưới đây là ví dụ cURL cơ bản để xác minh kết nối và nhận phản hồi văn bản.

Copycurl https://api.speechtotextapis.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."}]
  }'

Yêu cầu này trả về một đối tượng JSON với văn bản được tạo. Nếu khóa không hợp lệ, bạn 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 nhận được lỗi 402. Đây là các lỗi chính cần kiểm tra trước khi gỡ lỗi logic.

Tích hợp SDK Python

Đối với nhà phát triển Python, thư viện openai chính thức hoạt động ngay lập tức. Khởi tạo client với khóa và base URL tùy chỉnh của bạn. Truyền ID mô hình uncensored trong lệnh gọi hoàn thành hội thoại của bạn. Cách tiếp cận này lý tưởng để xử lý hậu kỳ đầu ra ASR, làm sạch nhiễu phiên âm hoặc trích xuất dữ liệu có cấu trúc từ văn bản thô. Bản chất không kiểm duyệt đảm bảo rằng nếu bản ghi âm của bạn chứa hội thoại người lớn hoặc các thuật ngữ gây tranh cãi, LLM sẽ xử lý mà không chặn hoặc viết lại để giữ sự lịch sự. Điều này rất quan trọng đối với các pipeline sáng tạo nơi độ trung thực với âm thanh nguồn là ưu tiên hàng đầu. SDK xử lý tự động việc phân đoạn token và logic thử lại.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.speechtotextapis.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)

Hãy nhớ rằng định danh mô hình là uncensored. Đừng thay thế nó bằng gpt-4 hoặc các định danh chung khác, vì những định danh đó có thể không định tuyến đến trọng số không kiểm duyệt cụ thể của chúng tôi.

Tích hợp SDK Node.js

Nhà phát triển Node.js có thể sử dụng gói npm openai tương tự. Đặt apiKey và baseURL trong hàm tạo client. Sau đó gọi chat.completions.create với mô hình uncensored. Điều này hữu ích cho các kịch bản chú thích thời gian thực hoặc các nhiệm vụ tạo văn bản phía máy chủ. API hỗ trợ các tải trọng JSON tiêu chuẩn. Bạn có thể bao gồm các thông báo hệ thống để xác định giọng điệu hoặc vai trò của trợ lý. Mô hình không kiểm duyệt phản hồi trực tiếp với các prompt này mà không có các lớp bảo vệ bổ sung có thể làm thay đổi đầu ra sáng tạo. Đảm bảo bạn xử lý luồng phản hồi nếu bạn đang xử lý các tài liệu lớn. SDK Node trừu tượng hóa các chi tiết HTTP, cho phép bạn tập trung vào logic pipeline văn bản.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.speechtotextapis.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);

Giới hạn tốc độ áp dụng cho mỗi khóa. Nếu bạn vượt quá 300 yêu cầu mỗi phút, API sẽ trả về lỗi 429. Hãy triển khai cơ chế backoff theo cấp số nhân trong logic thử lại của bạn để xử lý tình huống này một cách nhẹ nhàng.

Phản hồi truyền phát (SSE)

Đối với các ứng dụng độ trễ thấp, hãy bật truyền phát bằng cách đặt stream: true trong yêu cầu của bạn. API trả về các chunk Sự kiện gửi bởi máy chủ (SSE). Mỗi chunk chứa một phần delta văn bản riêng lẻ. Điều này rất cần thiết cho chú thích trực tiếp hoặc các giao diện trò chuyện tương tác. Mô hình không kiểm duyệt hỗ trợ truyền phát gốc. Bạn không cần chờ hoàn tất đầy đủ để bắt đầu hiển thị văn bản. Điều này giảm đáng kể độ trễ cảm nhận. Định cấu hình SDK của bạn để xử lý các sự kiện luồng. Trong Python, lặp qua đối tượng luồng. Trong Node, hãy sử dụng trình lặp bất đồng bộ. Luồng kết thúc bằng một chunk cuối cùng chứa lý do kết thúc. Phương pháp này hiệu quả cho băng thông và trải nghiệm người dùng.

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)

Truyền phát không thay đổi việc tính phí token. Bạn sẽ được tính phí cho tổng số token đầu vào và đầu ra bất kể bạn có truyền phát hay yêu cầu phản hồi đầy đủ hay không.

Giới hạn & Ràng buộc

Tài khoản của bạn có giới hạn cứng là 300 yêu cầu mỗi phút trên mỗi khóa API. Thân yêu cầu không được vượt quá 8 MB. Cửa sổ ngữ cảnh là 100.000 token, bao gồm cả prompt và hoàn thành. Điều này đủ cho hầu hết các nhiệm vụ xử lý tài liệu và phiên âm ngữ cảnh dài. Nếu bạn gửi một prompt vượt quá cửa sổ, API sẽ trả về lỗi. Mô hình không kiểm duyệt chỉ chặn một giới hạn cứng cụ thể: nội dung tình dục liên quan đến trẻ em. Mọi nội dung người lớn hợp pháp khác đều được phép. Điều này làm cho nó lý tưởng cho các pipeline truyền thông nơi sự đa dạng nội dung được mong đợi. Không có gói đăng ký; bạn trả tiền theo mức sử dụng. Tín dụng trả trước không hết hạn. Sử dụng endpoint GET /v1/models để xác minh khả dụng nếu cần, mặc dù ID mô hình luôn là uncensored.