Các phương pháp khắc phục sự cố mã lỗi, xác thực, giới hạn tốc độ, chặn tạm thời, giao diện và các vấn đề về phí. Bao gồm các bước kiểm tra đầy đủ, xác minh thực tế và xử lý lỗi.

Lỗi phổ biến với 429

Khi gặp lỗi, trước tiên hãy kiểm tra trạng thái HTTP và phiên bản trả về error.message、error.code và số yêu cầu. Cùng một mã trạng thái có thể xuất phát từ các giai đoạn khác nhau, và nguyên nhân gốc rễ không thể xác nhận chỉ bằng con số.

Trạng thái chung

Các lỗi kinh doanh như số dư không đủ, mô hình không khả dụng hoặc giá cả không được cấu hình cũng nên được đọc và trả về phần chính; bạn không thể chỉ nhìn vào mã trạng thái hoặc cửa sổ bật lên giao diện.

429 Không nhất thiết là bạn "đòi hỏi quá nhiều"

429 chỉ ra rằng một lớp nhất định giới hạn yêu cầu. Hiện tại, mỗi thông tin xác thực có thể được xử lý cùng lúc tối đa 2 yêu cầu, giới hạn tần số cuộc gọi mô hình là 60 nhịp mỗi phút； Upstream cũng có giới hạn tài nguyên và mức sử dụng riêng.

• concurrency_limit: Chờ yêu cầu hiện tại được hoàn thành trước khi gửi yêu cầu tiếp theo. Các yêu cầu luồng vẫn chiếm thời gian đồng thời cho đến khi kết thúc.
• Giới hạn tần số thông thường hoặc 429 phía thượng: tuân thủ Retry-After(Nếu có), sử dụng số lần thử lại giới hạn với thời gian chờ kéo dài dần để tránh các yêu cầu lặp lại ngay lập tức.
• Trang hiển thị trực tiếp LỖI HTTP 429: Yêu cầu trang trình duyệt cũng có thể bị hạn chế; Chờ một chút trước khi làm mới; nếu vẫn tiếp tục, hãy giữ lại thời gian và đường dẫn xuất hiện cho quản trị viên.

Nếu một vấn đề văn bản thông thường bị đánh giá sai, số yêu cầu và các ghi chú không nhạy cảm cần thiết có thể được cung cấp để xem xét; Không gửi các khóa, mật khẩu hoặc văn bản gốc nhạy cảm đầy đủ.

403 Niêm phong tạm thời bằng phiếu quà tặng

content_policy_violation Điều này cho thấy yêu cầu này đã đáp ứng các hạn chế sử dụng của trang web và bị từ chối trước khi gửi lên upstream.

credential_temporarily_blocked Trở về 403, và cung cấp Retry-After Nhắc chờ: Sau khi cùng một thông tin đăng nhập nhập vào quy tắc nhiều lần trong vòng 30 phút, hãy tạm dừng trong 30 phút. Vui lòng dừng nội dung liên quan và chờ khôi phục; không tiếp tục cố gắng bằng cách thay đổi khóa. Điều này khác với đồng thời 429 hoặc giới hạn tần suất.

Vấn đề địa chỉ giao diện và mô hình

URL cơ sở nên là https://api.baiyun.si/v1, địa chỉ Chat đầy đủ là /v1/chat/completions, Phản hồi địa chỉ: /v1/responses。 Kiểm tra trùng lặp /v1/v1, và liệu khách hàng có chọn các giao thức không mở trên trang web này hay không.

Tên mô hình phải được liên kết vớiMô hình vuôngvà khóa hiện tại /v1/models Trả về nhất quán; không sử dụng bí danh hiển thị phía khách để thay thế tên gọi thực tế.

Vấn đề về phát trực tuyến và chi phí

Chat SSE nên đọc [DONE]； Responses SSE nên đọc toàn bộ phần kết của sự kiện. Một số văn bản sau khi ngắt mạng không thể được coi là phản hồi thành công hoàn toàn.

Thông số đầu vào và đầu ra không đảm bảo giới hạn chi phí cứng. Các yêu cầu bình thường, lỗi sau khi nhập thượng nguồn, hoặc hủy bỏ của khách hàng phải được kiểm tra với các hồ sơ tiêu thụ thực tế; Chỉ các yêu cầu bị từ chối cục bộ và không đi lên phía trên mới không bị tính phí cho cuộc gọi mô hình này.

Những gì được cung cấp trong quá trình kiểm tra?

1. Múi giờ và múi giờ.
2. Số yêu cầu, tên mẫu, đường dẫn giao diện và trạng thái HTTP.
3. Thông báo lỗi sau khi xóa khóa và nội dung nhạy cảm.
4. Đối với các câu hỏi về thanh toán, hãy cung cấp số đơn hàng và trạng thái, nhưng không cung cấp khóa cửa hàng thanh toán.

Trạm vẫn đang dần cải thiện và chưa cam kết phản hồi thủ công 24/7 hoặc giới hạn thời gian xử lý cố định.

Danh sách kiểm tra trước khi sử dụng thực tế

1. Hãy chuẩn bị tài khoản và khóa truy cập của riêng bạn, và không sử dụng thông tin đăng nhập chung của người khác.
2. Ghi lại các phiên bản máy khách, hệ thống và mô hình cần sử dụng để dễ dàng tái tạo trong quá trình khắc phục sự cố.
3. Lưu cấu hình gốc hoặc ảnh chụp màn hình, ẩn khóa, mã xác minh và nội dung riêng tư.
4. Xác nhận rằng kiểm tra có thể tiêu tốn một lượng nhỏ DK, bắt đầu với một câu duy nhất và một yêu cầu duy nhất.
5. Xem lại trang plaza và trạng thái mô hình hiện tại trước khi quyết định có bật thêm tính năng hay không.

Điều tra chi tiết: thu hẹp phạm vi vấn đề để

Đầu tiên, xác nhận tài khoản đã đầy đủ, khóa hợp lệ và số dư DK đủ, sau đó xác minh giao thức, địa chỉ và mẫu mã sản phẩm. Thực hiện yêu cầu văn bản tối thiểu bằng cùng khóa; Chỉ sau khi thành công thì nó mới khôi phục tệp đính kèm, công cụ hoặc tự động thử lại từng mục. Sau khi lưu cấu hình máy khách, mở lại phiên làm việc để tránh sử dụng nhà cung cấp trước đó trong phiên cũ.

Cách xác nhận rằng phần này đã được học

Đừng chỉ kiểm tra vào thông báo "Cấu hình đã lưu thành công". Bạn nên có thể trình bày rõ ràng URL cơ sở hiện tại, cách sử dụng khóa, mô hình đã chọn và giao thức yêu cầu, đồng thời xác minh kết quả thao tác trên bảng điều khiển tương ứng. Hướng dẫn phía máy khách sử dụng một phản hồi văn bản thuần duy nhất và nhật ký tương ứng làm tiêu chuẩn hoàn thành ban đầu; Hướng dẫn tài khoản dựa trên thông tin bảo mật toàn diện; Hướng dẫn thanh toán sử dụng sự tương ứng giữa phí chính, phí kênh và DK làm tiêu chuẩn.

Nếu xảy ra lỗi, hãy ghi lại thời gian xảy ra, trạng thái HTTP, nội dung lỗi ẩn danh và kết quả thực tế dự kiến. Không chụp màn hình toàn bộ khóa trang, và không cung cấp mật khẩu hoặc mã xác minh cho người khác. Đối với 401, xác thực nên được giải quyết trước; đối với 400, các tham số nên được giải quyết trước; đối với 429, các lần thử lại quy mô lớn nên được dừng lại; đối với 404, cần xác minh các đường dẫn yêu cầu và xác minh trước; việc nạp lại không thể khắc phục tất cả các lỗi.

Một nhiệm vụ nhỏ phù hợp để luyện tập

Hoàn thành các bước tối thiểu trong phần này trong môi trường thử nghiệm của bạn, ghi lại bằng văn bản "cách bạn thiết lập ban đầu, mục bạn đã chỉnh sửa và kết quả bạn thấy." Đừng xem dữ liệu sản xuất, thanh toán thực tế hoặc các lệnh không thể phục hồi là những bài tập. Nếu bạn gặp các tính năng vượt quá những gì phần này cung cấp, trước tiên hãy xem hướng dẫn giao thức tương ứng trước khi cân nhắc thêm tính năng; Chỉ thay đổi một cấu hình tại một thời điểm giúp dễ dàng đánh giá bước nào dẫn đến lỗi.

Bước tiếp theo là ranh giới của phiên bản

Quay lại bản đồ học tập đầy đủ · Cấu hình trang API được đơn giản hóa · Tình trạng thời gian thực của trang web này。

Hướng dẫn được biên soạn vào ngày 9 tháng 10 năm 2026. Giao diện và khả năng cụ thể có thể khác nhau tùy theo phiên bản khách hàng và upstream; Hướng dẫn cấu hình không có nghĩa là tất cả các phiên bản client đều đã vượt qua bài kiểm tra. Đối với thanh toán số dư, đăng nhập QQ / Alipay và các kênh mở, vui lòng tham khảo trang thực tế; Giao diện nén: Trước đây, các kênh hình ảnh upstream 404 và raw không khả dụng, nên đừng nghĩ rằng các tệp cấu hình có thể tự động bị xóa.