sử dụng sai base_url
Sử dụng URL gốc OpenAI tiêu chuẩn sẽ khiến các yêu cầu của bạn bị lỗi hoặc định tuyến đến một mô hình hoàn toàn khác. API của chúng tôi yêu cầu bạn thay đổi base_url để https://api.whatisopenrouterai.com/v1. Một dòng cấu hình đơn lẻ đảm bảo SDK của bạn kết nối với máy chủ của chúng tôi thay vì cơ sở hạ tầng OpenAI toàn cầu.
Nhiều nhà phát triển sao chép và dán mã hiện có của họ mà không cập nhật biến này. Nếu bạn giữ nguyên URL mặc định, bạn sẽ nhận được lỗi 404 hoặc chạm vào một mô hình không được không kiểm duyệt. Luôn xác minh kết nối bằng cách kiểm tra /v1/models endpoint. Bạn sẽ thấy ID mô hình cụ thể của chúng tôi được liệt kê ở đó. Điều này xác nhận việc định tuyến là chính xác trước khi bạn gửi yêu cầu hoàn thiện đầu tiên.
quên đặt id mô hình
Ngay cả với URL cơ sở chính xác, việc bỏ qua ID mô hình sẽ mặc định sang một mô hình chung hoặc cũ hơn. Bạn phải đặt rõ ràng model tham số thành "uncensored" trong mọi yêu cầu. Điều này cho biết lớp định tuyến của chúng tôi phục vụ mô hình trọng lượng mở cụ thể đã được tinh chỉnh cho nội dung không giới hạn.
Không có hướng dẫn rõ ràng này, bạn có thể nhận được một mô hình khác với các quy tắc căn chỉnh khác nhau. Một số mô hình từ chối các chủ đề người lớn hợp pháp theo mặc định. Bằng cách buộc uncensored ID, bạn đảm bảo hành vi mà bạn mong đợi. Kiểm tra mã của bạn xem có bất kỳ tên mô hình được mã hóa cứng nào có thể ghi đè các mặc định SDK của bạn hay không.
bỏ qua giới hạn token và lỗi
Vượt quá cửa sổ ngữ cảnh 100.000 token hoặc giới hạn đầu ra 16.000 token sẽ gây ra lỗi yêu cầu ngay lập tức. API của chúng tôi áp dụng giới hạn đầu ra tối đa là 16.000 token cho mỗi yêu cầu. Nếu bạn không đặt max_tokens, mặc định chỉ là 2.048 token. Điều này thường quá ngắn cho các nhiệm vụ suy luận phức tạp.
Lỗi và từ chối không tiêu thụ tín dụng trả trước của bạn. Tuy nhiên, các yêu cầu bị lỗi làm tăng giới hạn tốc độ hoặc vượt quá kích thước thân (8 MB) vẫn được tính vào hạn ngạch của bạn. Theo dõi các tiêu đề phản hồi của bạn để biết việc sử dụng token. Điều chỉnh kỹ thuật prompt của bạn để phù hợp với cửa sổ ngữ cảnh. Điều này ngăn ngừa các lần thử lại tốn kém và đảm bảo luồng dữ liệu mượt mà.
hiểu sai về thanh toán trả trước
Số dư tài khoản của bạn được liên kết với số dư trả trước, không phải gói đăng ký hàng tháng. Chúng tôi tính phí $0.15 cho mỗi 1M token đầu vào và $0.50 cho mỗi 1M token đầu ra. Lỗi miễn phí, nhưng các bản hoàn thành thành công sẽ tiêu thụ số dư. Bạn phải nạp tiền bằng crypto để duy trì khả năng cung cấp dịch vụ.
Chúng tôi chấp nhận USDT (TRC20) hoặc USDC (Base) cho các khoản nạp tiền. Khoản nạp tối thiểu bắt đầu từ $20. Bonus áp dụng ở các mức cao hơn: +5% từ $50, +10% từ $100, và +15% từ $200. Tín dụng không bao giờ hết hạn. Đảm bảo số dư của bạn dương trước khi chạy các lô lớn. Kiểm tra bảng điều khiển để xác minh số dư hiện tại và các giao dịch gần đây.
nhầm lẫn giữa streaming và phản hồi tiêu chuẩn
Streaming qua SSE thay đổi cách bạn phân tích luồng phản hồi. Phản hồi tiêu chuẩn trả về một đối tượng JSON duy nhất. Streaming trả về nhiều chunk. Bạn phải xử lý chunk cuối cùng để nhận được thống kê sử dụng token chính xác.
Cấu trúc streaming của chúng tôi bao gồm việc sử dụng token trong chunk cuối cùng. Nếu bạn dừng đọc stream sớm, bạn có thể bỏ lỡ dữ liệu này. Hãy đảm bảo thư viện client của bạn hỗ trợ SSE đúng cách. Điều này rất quan trọng đối với các ứng dụng thời gian thực nơi bạn hiển thị token khi chúng được tạo ra. Streaming được cấu hình sai có thể dẫn đến văn bản không đầy đủ hoặc trạng thái giao diện người dùng bị lỗi.
lỗi cấu hình tool_choice
Sai tool_choice cài đặt có thể ngăn việc gọi hàm hoạt động như dự kiến. Bạn có thể buộc một công cụ cụ thể hoặc để mô hình tự quyết định. Cấu hình sai thường dẫn đến việc mô hình bỏ qua các hàm có sẵn.
Sử dụng tool_choice để kiểm soát việc mô hình có tự động gọi công cụ hay không. Đặt nó thành "auto" cho sự linh hoạt hoặc chỉ định ID công cụ cho hành vi nghiêm ngặt. Đảm bảo các định nghĩa hàm của bạn khớp với lược đồ dự kiến. Điều này tránh lỗi thời gian chạy khi mô hình cố gắng gọi một hàm không tồn tại. Kiểm tra kỹ các định nghĩa công cụ của bạn trước khi triển khai sang môi trường sản xuất.
chế độ json_object bị thiếu
Không response_format: {"type": "json_object"}, mô hình có thể xuất ra markdown hoặc văn bản thuần túy. Điều này làm hỏng các trình phân tích cú pháp mong đợi JSON nghiêm ngặt. Bật chế độ JSON để đảm bảo đầu ra nhất quán, có thể phân tích cú pháp.
Tính năng này rất cần thiết cho việc tích hợp với các hệ thống xử lý dữ liệu sau yêu cầu dữ liệu có cấu trúc. Nó giảm đáng kể chi phí xử lý sau. Luôn xác thực lược đồ đầu ra trong mã máy khách của bạn. Điều này đảm bảo tính mạnh mẽ chống lại các ảo giác mô hình thỉnh thoảng. Sử dụng chế độ này khi trích xuất thực thể hoặc tạo tệp cấu hình.
những bất ngờ về giới hạn tốc độ
API của chúng tôi cho phép 300 yêu cầu mỗi phút trên mỗi khóa. Vượt quá giới hạn này sẽ dẫn đến phản hồi 429 Too Many Errors. Các yêu cầu đồng thời được giới hạn ở 8 trên mỗi khóa. Hãy lập kế hoạch các cài đặt độ đồng thời của bạn cho phù hợp.
Nếu bạn chạy nhiều tiến trình, hãy đảm bảo chúng chia sẻ cùng một khóa hoặc tạo các khóa riêng biệt. Mỗi tài khoản hỗ trợ một khóa hoạt động. Khóa mới sẽ thay thế khóa cũ. Hãy theo dõi các tiêu đề giới hạn tốc độ trong phản hồi. Triển khai cơ chế tăng dần theo cấp số nhân trong logic thử lại của bạn. Điều này ngăn ngừa các lỗi dây chuyền trong các giai đoạn lưu lượng truy cập cao.
trì hoãn nạp tiền điện tử
Các giao dịch crypto có thể mất thời gian để xác nhận trên blockchain. Tín dụng của bạn có thể không xuất hiện ngay lập tức sau khi gửi tiền. Hãy sử dụng đúng mạng lưới: TRC20 cho USDT hoặc Base cho USDC. Gửi sai mạng lưới sẽ gây mất tiền.
Nạp tiền từ $20 đến $500. Đảm bảo bạn gửi đúng số tiền hoặc tính cả phí mạng. Kiểm tra hash giao dịch trên trình khám phá blockchain. Nếu tín dụng bị chậm, hãy liên hệ bộ phận hỗ trợ với ID giao dịch. Đừng giả định thanh toán đã thất bại ngay lập tức. Sự kiên nhẫn trong thời gian tắc nghẽn mạng là chìa khóa cho hoạt động trơn tru.
