Tích hợp routerapi trong vài phút

Xác thực và Thiết lập Base URL

Thay đổi base_url và api_key để chuyển đổi nhà cung cấp ngay lập tức. Điểm SDK của bạn đến HTTPS://api.routerapi.cc/v1 và sử dụng khóa được tạo từ bảng điều khiển của bạn. Không cần quy tắc định tuyến phức tạp hoặc cấu hình đa mô hình. Các tiêu đề và thiết lập máy khách hiện có của bạn vẫn giống với tiêu chuẩn OpenAI.

Khóa được hiển thị ngay lập tức sau khi đăng ký qua Google hoặc email. Lưu trữ nó một cách an toàn và truyền nó dưới dạng Bearer token trong tiêu đề Authorization HTTP của bạn. Thay đổi đơn giản này định tuyến tất cả các yêu cầu đến mô hình không kiểm duyệt của chúng tôi mà không làm thay đổi mã ứng dụng của bạn.

Gửi Yêu cầu Hoàn thành Trò chuyện

Gửi một yêu cầu tiêu chuẩn POST yêu cầu đến /v1/chat/completions để tạo văn bản. Điểm cuối này chấp nhận cùng cấu trúc JSON được sử dụng bởi OpenAI, đảm bảo các prompt của bạn hoạt động mà không cần sửa đổi. Sử dụng ID mô hình uncensored để truy cập mô hình ngôn ngữ lớn của chúng tôi được tinh chỉnh cho các phản ứng không giới hạn.

Mỗi yêu cầu tiêu thụ token từ số dư trả trước của bạn. Lỗi và từ chối không tính phí tín dụng của bạn, vì vậy bạn có thể kiểm tra tự do. Ví dụ sau đây minh họa một lệnh gọi tạo văn bản cơ bản bằng SDK chính thức.

Copycurl https://api.routerapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this 1000 word article in three sentences."}]
  }'

Phản hồi trả về văn bản được tạo trong choices[0].message.content trường. Bạn có thể điều chỉnh các tham số như temperature hoặc top_p để kiểm soát độ sáng tạo. Không có các điểm cuối nhúng hoặc tạo hình ảnh; dịch vụ này tập trung hoàn toàn vào việc hoàn thiện văn bản.

Xử lý phản hồi phát trực tiếp (SSE)

Bật phát trực tiếp bằng cách đặt stream: true trong thân yêu cầu của bạn. API trả về Sự kiện được gửi bởi máy chủ (SSE) để phân phối token theo thời gian thực. Điều này giảm độ trễ cảm nhận đối với các giao diện trò chuyện và ứng dụng đóng vai. Mỗi chunk chứa một phần delta của phản hồ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)

Chunk cuối cùng bao gồm thống kê sử dụng token đầy đủ cho yêu cầu. Hãy phân tích content field từ mỗi delta để tái tạo thông điệp đầy đủ. Cách tiếp cận này giữ cho giao diện người dùng của bạn phản hồi nhanh trong khi mô hình xử lý các ngữ cảnh dài. Số lượng token trong chunk cuối cùng phản ánh cả việc sử dụng đầu vào và đầu ra.

Sử dụng Công cụ và Function Calling

Định nghĩa định nghĩa công cụ trong tools tham số để kích hoạt gọi hàm. Mô hình trả về các lệnh gọi công cụ có cấu trúc trong phản hồi thay vì văn bản thuần túy. Chỉ định tool_choice để buộc mô hình sử dụng một hàm cụ thể hoặc tự chọn. Tính năng này hoạt động giống hệt với định dạng gọi hàm của OpenAI.

Copyfrom openai import OpenAI

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

Xác định các hàm của bạn với các lược đồ JSON và truyền chúng trong yêu cầu. API xử lý việc định tuyến giữa việc tạo văn bản và việc gọi công cụ. Sử dụng response_format với {"type": "json_object"} cho đầu ra JSON nghiêm ngặt khi không cần công cụ. Điều này đảm bảo dữ liệu có cấu trúc nhất quán cho các dịch vụ backend của bạn.

Đang thiết lập Chế độ JSON cho Đầu ra Có cấu trúc

Buộc mô hình xuất ra JSON hợp lệ bằng cách đặt response_format để {"type": "json_object"}. Điều này rất cần thiết để phân tích dữ liệu trong các quy trình tự động hóa hoặc AI agent. Mô hình sẽ cố gắng đóng tất cả các dấu ngoặc và tuân theo lược đồ được yêu cầu. Lỗi có thể xảy ra nếu đầu ra quá dài so với cửa sổ ngữ cảnh.

Copyimport OpenAI from "openai";

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

Kết hợp chế độ JSON với temperature được đặt thành 0 để có tính xác định tối đa. Sử dụng điều này để trích xuất thực thể, định dạng dữ liệu hoặc tạo tệp cấu hình. Mô hình không kiểm duyệt xử lý tốt các cấu trúc lồng nhau phức tạp. Luôn xác minh đầu ra trong mã của bạn trước khi xử lý.

Hiểu về Giới hạn Token và Chi phí

Cửa sổ ngữ cảnh hỗ trợ 100.000 token cho tổng cộng cả prompt và completion. Mỗi yêu cầu có thể xuất tối đa 16.000 token, hoặc 2.048 nếu max_tokens chưa được đặt. Giá là $0.15 cho mỗi triệu token đầu vào và $0.50 cho mỗi triệu token đầu ra. Tín dụng không bao giờ hết hạn và các lỗi được miễn phí.

Theo dõi mức sử dụng qua bảng điều khiển hoặc các tiêu đề phản hồi. Các yêu cầu bị giới hạn ở kích thước thân 8 MB. Bạn có thể nạp tiền bằng USDT (TRC20) hoặc USDC (Base) bắt đầu từ $20. Số dư bonus tăng với các khoản nạp lớn hơn: +5% ở $50, +10% ở $100 và +15% ở $200. Không áp dụng phí đăng ký.