Hướng dẫn nhanh cho người dùng OpenRouter NSFW

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

Thay thế base URL của nhà cung cấp hiện tại bằng https://api.openrouternsfw.com/v1. Xác thực sử dụng tiêu đề Authorization: Bearer <key> tiêu chuẩn. Bạn nhận được khóa ngay sau khi đăng nhập qua Google hoặc email trên trang Lấy khóa API. Không cần số điện thoại và khóa chỉ hiển thị một lần, nên hãy sao chép trước khi rời trang.

Dịch vụ của chúng tôi là một API độc lập, không phải là nhà bán lại các mô hình của các nhà cung cấp khác. Mã định danh mô hình bạn gửi trong yêu cầu là uncensored, chạy trên máy chủ riêng của chúng tôi. Nó đượ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, nhưng nó không phải là mô hình GPT, Claude hoặc bất kỳ mô hình nhà cung cấp có tên nào khác.

Đảm bảo thư viện client của bạn được cấu hình để sử dụng URL cơ sở mới này. Tất cả yêu cầu phải bao gồm khóa API hợp lệ trong tiêu đề. Nếu khóa bị thiếu hoặc không hợp lệ, máy chủ sẽ trả về lỗi 401. Nếu bạn không có tín dụng trả trước, bạn sẽ nhận được lỗi 402. Đây là các mã trạng thái HTTP tiêu chuẩn cho biết các vấn đề về xác thực hoặc thanh toán, không phải lỗi máy chủ.

Endpoint Chat Completions

Chức năng cốt lõi được cung cấp qua POST /v1/chat/completions endpoint. Endpoint này chấp nhận một JSON body chứa tên mô hình, mảng messages và các tham số tùy chọn. Nó trả về một JSON object với văn bản được tạo ra, thống kê sử dụng token và lý do kết thúc. Cấu trúc này tương thích với các SDK chính thức của OpenAI và hầu hết các thư viện client tương thích OpenAI.

Bạn không cần viết các client HTTP tùy chỉnh nếu bạn thích sử dụng SDK. Tuy nhiên, bạn phải cập nhật cấu hình để trỏ đến base URL của chúng tôi. Ví dụ sau đây minh họa một yêu cầu hoàn tất tiêu chuẩn bằng cURL. Yêu cầu này gửi một prompt đến mô hình không kiểm duyệt và mong đợi một phản hồi văn bản.

Sao chépcurl https://api.openrouternsfw.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."}]
  }'

Hãy nhớ rằng API này chỉ phục vụ văn bản. Không có endpoint embedding, tạo hình ảnh, âm thanh hoặc video. Nếu ứng dụng của bạn yêu cầu đầu vào hoặc đầu ra đa phương tiện, bạn sẽ cần xử lý những phần đó riêng biệt. Dịch vụ của chúng tôi tập trung hoàn toàn vào việc tạo văn bản chất lượng cao với mô hình không kiểm duyệt.

Tích hợp SDK Python

Sử dụng SDK Python giúp đơn giản hóa quá trình tích hợp. Khởi tạo client với base URL chính xác và khóa API của bạn. Thư viện xử lý các yêu cầu HTTP và phân tích JSON cho bạn. Bạn có thể chỉ định ID mô hình là uncensored để đảm bảo bạn đang sử dụng mô hình cụ thể của chúng tôi.

Sao chépfrom openai import OpenAI

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

Đoạn mã này minh họa cách gửi một tin nhắn và lấy phản hồi. Client tự động xử lý kết nối và báo cáo lỗi. Nếu máy chủ trả về lỗi, SDK sẽ ném ra một ngoại lệ. Bạn nên xử lý các ngoại lệ này trong logic ứng dụng của mình để cung cấp trải nghiệm người dùng tốt hơn.

SDK Python chỉ là một tùy chọn. Bạn có thể sử dụng bất kỳ ngôn ngữ nào hỗ trợ yêu cầu HTTP. Cấu trúc endpoint vẫn giữ nguyên bất kể client bạn chọn. Sự linh hoạt này cho phép bạn tích hợp mô hình không kiểm duyệt vào bất kỳ quy trình làm việc hiện có nào mà không cần thay đổi mã đáng kể.

Sử dụng SDK Node.js

SDK Node hoạt động tương tự như phiên bản Python. Cấu hình client với base URL và khóa API, sau đó gọi phương thức hoàn tất trò chuyện. Cách tiếp cận này lý tưởng cho các ứng dụng phía máy chủ hoặc dịch vụ backend cần tạo văn bản không đồng bộ.

Sao chépimport OpenAI from "openai";

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

Các nhà phát triển Node.js có thể dễ dàng tích hợp API này vào các dự án hiện có của họ. SDK xử lý việc tuần tự hóa và giải tuần tự hóa dữ liệu JSON. Bạn cũng có thể chỉ định các tham số bổ sung như temperature hoặc top_p để kiểm soát độ ngẫu nhiên của đầu ra.

Hãy đảm bảo xử lý đúng bản chất không đồng bộ của các yêu cầu. Sử dụng async/await hoặc chuỗi Promise để quản lý dữ liệu phản hồi. Điều này đảm bảo ứng dụng của bạn vẫn phản hồi trong khi chờ mô hình tạo văn bản. SDK Node là một lựa chọn đáng tin cậy để xây dựng các dịch vụ tạo văn bản có thể mở rộng.

Phản hồi truyền phát

Bật truyền phát bằng cách đặt tham số stream thành true trong yêu cầu của bạn. Máy chủ sẽ gửi một chuỗi các Sự kiện do Máy chủ Gửi (SSE) thay vì một phản hồi JSON duy nhất. Mỗi sự kiện chứa một phần nhỏ văn bản được tạo.

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)

Truyền phát hữu ích cho các ứng dụng thời gian thực nơi bạn muốn hiển thị đầu ra khi nó được tạo. Chunk cuối cùng của luồng chứa tổng số token được sử dụng cho yêu cầu. Điều này cho phép bạn theo dõi chi phí chính xác mà không cần chờ phản hồi hoàn tất.

Xử lý các sự kiện luồng cẩn thận để đảm bảo văn bản được lắp ráp chính xác. Nối các chunk theo thứ tự chúng được nhận. Máy chủ đảm bảo rằng các chunk được gửi theo thứ tự. Nếu kết nối bị gián đoạn, bạn có thể cần thử lại yêu cầu. Truyền phát là một tính năng mạnh mẽ nâng cao trải nghiệm người dùng cho các nhiệm vụ tạo văn bản.

Giới hạn tốc độ và cửa sổ ngữ cảnh

Mỗi khóa API được giới hạn ở 300 yêu cầu mỗi phút và 8 yêu cầu đồng thời. Kích thước body của yêu cầu được giới hạn ở 8 MB. Nếu bạn vượt quá các giới hạn này, máy chủ sẽ trả về mã trạng thái 429. Đây là mã trạng thái HTTP tiêu chuẩn cho biết bạn đã gửi quá nhiều yêu cầu trong một khoảng thời gian nhất định. Bạn nên triển khai cơ chế backoff theo cấp số nhân trong client của mình để xử lý các lỗi này một cách mượt mà.

Cửa sổ ngữ cảnh hỗ trợ lên đến 100,000 token cho prompt và phần hoàn thành kết hợp. Không có giới hạn đầu ra riêng biệt. Nếu bạn không chỉ định tham số max_tokens, phản hồi có thể chạy đến hết cửa sổ. Bạn có thể giới hạn độ dài đầu ra bằng cách đặt max_tokens thành giá trị thấp hơn.

Theo dõi việc sử dụng token của bạn để quản lý tín dụng trả trước của mình một cách hiệu quả. Lỗi và từ chối không tiêu thụ token, vì vậy bạn không phải trả tiền cho các yêu cầu thất bại. Điều này đảm bảo bạn chỉ trả tiền cho việc tạo văn bản thành công. Hãy theo dõi các giới hạn tốc độ của bạn để tránh gián đoạn dịch vụ.