Hướng dẫn tích hợp API OpenRouter

Tại sao nên chuyển điểm cuối API OpenRouter của bạn?

Nhiều nhà phát triển gặp phải giới hạn tốc độ hoặc bộ lọc nội dung khi sử dụng các gói miễn phí của các mô hình không kiểm duyệt phổ biến. Bạn có thể thấy các lỗi như "không tìm thấy điểm cuối" hoặc giảm tốc độ đột ngột trong giờ cao điểm. Dịch vụ của chúng tôi cô lập mô hình Dolphin trên các máy chủ dành riêng để đảm bảo khả dụng cao. Điều này loại bỏ sự biến đổi của cơ sở hạ tầng định tuyến chia sẻ. Bạn có quyền truy cập trực tiếp vào một mô hình mạnh mẽ duy nhất mà không bị can thiệp bởi dữ liệu đào tạo. API vẫn hoàn toàn tương thích với OpenAI, có nghĩa là mã máy khách hiện có của bạn hoạt động mà không cần thay đổi cấu trúc. Phương pháp này đảm bảo độ trễ dự đoán được cho việc đóng vai hoặc tạo văn bản không giới hạn. Bạn tránh được sự thất vọng do các vấn đề định tuyến mô hình gây ra ở các bộ tổng hợp đa mô hình.

Bước 1: Lấy Khóa API không kiểm duyệt của bạn

Bạn có thể tạo khóa API ngay lập tức bằng cách đăng ký bằng email hoặc tài khoản Google. Không cần xác minh số điện thoại cho quy trình này. Sau khi đăng ký, khóa của bạn sẽ được hiển thị ngay trên bảng điều khiển. Mỗi tài khoản chỉ giới hạn một khóa hoạt động để đảm bảo theo dõi bảo mật. Nếu bạn cần một khóa mới, khóa cũ sẽ được thay thế ngay lập tức. Quy trình đăng ký tinh giản này cho phép bạn bắt đầu kiểm tra tích hợp của mình chỉ trong vài phút. Khóa này cấp quyền truy cập vào mô hình không kiểm duyệt mà không cần bất kỳ phí đăng ký nào. Bạn chỉ trả tiền cho các token bạn thực sự sử dụng.

Bước 2: Cập nhật Base URL của bạn

Để di chuyển ứng dụng của bạn, bạn phải cập nhật URL cơ sở trong cấu hình client tương thích OpenAI của mình. Định hướng SDK của bạn đến điểm cuối chuyên dụng của chúng tôi tại https://api.openrouterdolphinai.com/v1. URL này hoạt động với bất kỳ triển khai SDK OpenAI tiêu chuẩn nào. Bạn không cần thay đổi ID mô hình của mình; hãy sử dụng uncensored như định danh mô hình. Thay đổi đơn giản này định hướng các yêu cầu của bạn đến các máy chủ biệt lập của chúng tôi. Nó đảm bảo rằng lưu lượng truy cập của bạn không bị trộn với người dùng khác của các bộ tổng hợp chia sẻ. Điểm cuối hỗ trợ các quy trình trò chuyện tiêu chuẩn mà không yêu cầu các tiêu đề xác thực mới.

Bước 3: Kiểm tra với Endpoint /v1/chat/completions

Xác minh logic tích hợp của bạn bằng cách gửi yêu cầu POST tiêu chuẩn đến endpoint chat-completions. API của chúng tôi hỗ trợ cửa sổ ngữ cảnh 100.000 token cho cả prompt và hoàn thành kết hợp. Bạn có thể tạo tối đa 16.000 token mỗi yêu cầu nếu bạn chỉ định max_tokens. Giới hạn đầu ra mặc định là 2,048 token nếu bạn bỏ qua tham số này. Điểm cuối chấp nhận các tham số tiêu chuẩn như temperature, top_p, và stop. Điều này đảm bảo khả năng tương thích với các prompt và hướng dẫn hệ thống hiện có. Bạn cũng có thể buộc chế độ JSON bằng cách sử dụng response_format cho đầu ra dữ liệu có cấu trúc. Kiểm tra với một lệnh nhắc văn bản đơn giản xác nhận cấu hình của bạn là chính xác.

Bước 4: Bật Streaming cho đầu ra thời gian thực

Phản hồi dạng stream rất quan trọng đối với trải nghiệm người dùng mượt mà trong các ứng dụng nhập vai. API của chúng tôi hỗ trợ Server-Sent Events (SSE) để cung cấp token từng cái một. Bạn phải thiết lập stream tham số thành true trong yêu cầu của bạn. Chunk cuối cùng của luồng bao gồm tổng số token sử dụng cho yêu cầu. Điều này cho phép bạn theo dõi chi phí theo thời gian thực mà không cần thêm lệnh gọi API. Phát trực tiếp giảm độ trễ cảm nhận bằng cách phân phối nội dung ngay khi nó được tạo ra. Tính năng này rất quan trọng để duy trì sự tương tác trong các cuộc trò chuyện năng động. Cấu hình client của bạn để xử lý các luồng SSE một cách hiệu quả.

Bước 5: Cấu hình Function Calling

API của chúng tôi hỗ trợ gọi hàm với định dạng công cụ OpenAI tiêu chuẩn. Bạn có thể xác định các công cụ và chỉ định tool_choice cho thực thi tự động hoặc cụ thể. Điều này cho phép các quy trình phức tạp nơi mô hình quyết định chức năng nào sẽ gọi. API xử lý phân tích đối số công cụ và định dạng đầu ra một cách đáng tin cậy. Bạn có thể sử dụng điều này cho việc trích xuất dữ liệu có cấu trúc hoặc các hành động tự động. Gọi hàm hoạt động liền mạch với khả năng của mô hình không kiểm duyệt. Điều này làm cho API của chúng tôi phù hợp cho các kiến trúc đại lý nâng cao yêu cầu tích hợp công cụ bên ngoài. Đảm bảo các định nghĩa công cụ của bạn tuân theo định dạng lược đồ JSON tiêu chuẩn.

Xử lý giới hạn tốc độ và lỗi

Bạn bị giới hạn ở 300 yêu cầu mỗi phút mỗi khóa API. Điều này cho phép thông lượng cao trong khi vẫn duy trì sự ổn định của máy chủ. Bạn có thể có tối đa 8 yêu cầu đồng bộ hoạt động cùng lúc. Kích thước thân yêu cầu tối đa là 8 MB. Nếu vượt quá các giới hạn này, bạn sẽ nhận được lỗi giới hạn tốc độ tiêu chuẩn. Giá cả của chúng tôi minh bạch: $0.15 cho mỗi 1M token đầu vào và $0.50 cho mỗi 1M token đầu ra. Lỗi và từ chối không phát sinh chi phí. Số dư không bao giờ hết hạn, vì vậy bạn có thể nạp thêm khi thuận tiện. Mô hình trả tiền theo mức sử dụng này đảm bảo bạn chỉ trả tiền cho việc sử dụng thực tế.

Tại sao giải pháp thay thế API OpenRouter này tốt hơn cho NSFW

Nhiều nhà tổng hợp áp dụng bộ lọc nội dung hoặc định tuyến yêu cầu thông qua các mô hình có mức độ không kiểm duyệt khác nhau. Dịch vụ của chúng tôi cung cấp một mô hình Dolphin chuyên dụng duy nhất được tinh chỉnh cho việc tạo không giới hạn. Nó không từ chối các chủ đề người lớn, hư cấu hoặc gây tranh cãi hợp pháp. Giới hạn cứng duy nhất là nội dung liên quan đến trẻ vị thành niên. Sự nhất quán này rất quan trọng cho các ứng dụng nhập vai và viết sáng tạo. Bạn tránh được sự không chắc chắn của các bộ định tuyến đa mô hình có thể chuyển đổi mô hình giữa chừng. Cơ sở hạ tầng chuyên dụng đảm bảo rằng các tùy chọn nội dung của bạn được duy trì nhất quán trên tất cả các yêu cầu.

Danh sách kiểm tra cuối cùng cho Di chuyển Trơn tru

Trước khi đưa vào hoạt động, hãy xác minh URL cơ bản của bạn trỏ đến điểm cuối chuyên dụng của chúng tôi. Đảm bảo khóa API của bạn đang hoạt động và được định dạng chính xác. Kiểm thử cả phản hồi streaming và không streaming để xác nhận tính ổn định. Kiểm tra xem các công cụ gọi hàm của bạn có được xác định chính xác hay không. Xác nhận rằng việc theo dõi việc sử dụng token của bạn khớp với chunk SSE cuối cùng. Xác nhận phương thức thanh toán của bạn đã được thiết lập để nạp tiền bằng tiền điện tử. API của chúng tôi chấp nhận USDT trên TRC20 hoặc USDC trên Base. Hãy bắt đầu với khoản tín dụng dùng thử để xác thực quy trình làm việc của bạn trước khi cam kết thực hiện các khoản mua lớn hơn. Danh sách kiểm tra này đảm bảo quá trình chuyển đổi liền mạch từ nhà cung cấp trước đó của bạn.