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

Yêu cầu tiên quyết

Trước khi tích hợp, hãy đảm bảo bạn có một tài khoản hoạt động. Đăng ký qua Google hoặc email trên trang Nhận khóa API để nhận khóa duy nhất của bạn ngay lập tức. Bạn không cần thẻ tín dụng cho $0,50 dùng thử ban đầu. llm không kiểm duyệt của chúng tôi phục vụ id mô hình "uncensored" qua một endpoint tiêu chuẩn. URL cơ sở là https://api.vibevoice.top/v1. Thiết lập này hoạt động với bất kỳ SDK OpenAI nào, khiến nó trở thành giải pháp thay thế trực tiếp cho nhiều quy trình hiện có.

Xác thực

Chuyển khóa API của bạn trong tiêu đề Authorization. Định dạng phải là "Bearer YOUR_API_KEY". Nếu khóa bị thiếu hoặc không hợp lệ, API sẽ trả về lỗi 401. Vì chúng tôi tập trung vào xử lý văn bản, hãy đảm bảo quy trình của bạn chỉ gửi dữ liệu văn bản. Khóa được liên kết với một tài khoản; tạo khóa mới sẽ thay thế khóa cũ ngay lập tức. Sự đơn giản này cho phép lặp lại nhanh chóng trong môi trường phát triển của bạn.

Gửi yêu cầu

Thực hiện yêu cầu POST đến /v1/chat/completions. Bao gồm id mô hình, tin nhắn của bạn và bất kỳ tham số nào. Đây là một ví dụ cơ bản sử dụng cURL:

Copycurl https://api.vibevoice.top/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 gửi một hướng dẫn đơn giản đến mô hình. Phản hồi chứa văn bản được tạo. Bạn có thể điều chỉnh các tham số như nhiệt độ cho sự sáng tạo hoặc đặt giới hạn nghiêm ngặt về độ dài đầu ra. Cách tiếp cận trực tiếp này rất lý tưởng để tạo kịch bản, phụ đề hoặc biến thể prompt cho các công cụ khác.

Tích hợp SDK Python

Sử dụng thư viện Python OpenAI chính thức. Cấu hình URL cơ sở để trỏ đến dịch vụ của chúng tôi. Chuyển khóa API của bạn dưới dạng api_key. Điều này cho phép bạn sử dụng các phương thức quen thuộc như client.chat.completions.create(). Đây là một api tương thích openai, vì vậy cấu trúc mã hiện có của bạn có thể yêu cầu thay đổi tối thiểu. Phương pháp này hoàn hảo cho xử lý backend hoặc các nhiệm vụ trích xuất dữ liệu.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.vibevoice.top/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ớ xử lý ngoại lệ một cách khéo léo. Lỗi mạng hoặc giới hạn tốc độ có thể làm gián đoạn quy trình của bạn. Ghi nhật ký phản hồi giúp gỡ lỗi tại sao một prompt cụ thể có thể bị từ chối hoặc tạo ra đầu ra không mong đợi.

Tích hợp SDK Node

Đối với môi trường JavaScript, hãy sử dụng gói npm openai. Đặt các thuộc tính apiKey và baseURL trong đối tượng cấu hình. Điều này đảm bảo các yêu cầu đi đến endpoint chính xác. SDK Node hỗ trợ cùng các tham số như phiên bản Python. Nó lý tưởng cho máy chủ web hoặc các chức năng biên cần tạo văn bản theo yêu cầu.

Copyimport OpenAI from "openai";

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

Hãy đảm bảo bạn quản lý vòng đời của đối tượng client để tránh rò rỉ tài nguyên. Tích hợp này rất mạnh mẽ để xử lý các nhiệm vụ tạo văn bản bất đồng bộ trong các ứng dụng web hiện đại.

Phản hồi streaming

Bật streaming bằng cách đặt stream thành true trong yêu cầu của bạn. API trả dữ liệu theo từng phần khi chúng được tạo. Điều này hữu ích cho các hiển thị thời gian thực hoặc hiển thị văn bản tiến bộ. Chunk cuối cùng bao gồm thống kê sử dụng token đầy đủ. Streaming giảm độ trễ cảm nhận cho người dùng cuối.

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)

Xử lý stream đúng cách để đảm bảo tất cả dữ liệu được xử lý. Nếu kết nối bị ngắt, bạn có thể bỏ lỡ dữ liệu sử dụng cuối cùng. Tính năng này rất có giá trị cho các ứng dụng cần hiển thị văn bản khi nó đang được viết.