Hướng dẫn API Baiyun: Tích hợp tương thích OpenAI
Địa chỉ thống nhất, lựa chọn giao thức, yêu cầu tối thiểu và phạm vi tương thích. Bao gồm các bước kiểm tra đầy đủ, xác minh thực tế và xử lý lỗi.
Truy cập tương thích OpenAI
Ba tính năng cốt lõi
| Lĩnh vực | Trạm này được đánh giá cao |
|---|---|
| Base URL | https://api.baiyun.si/v1 |
| API Key | Mô hình gọi trong quản lý khóa |
| Mô hình | Sao chép chính xác tên từ hình vuông mô hình, ví dụ như gpt-6-luna |
Chat Completions và Responses là hai giao thức yêu cầu khác nhau, không phải hai khóa. Các ứng dụng chat thông thường thường sử dụng Chat; Các nhà cung cấp tùy chỉnh của Codex sử dụng Responses. Danh sách mẫu xe kèm giá cảMô hình vuôngsẽ chiến thắng.
Trước tiên, hãy kiểm tra danh sách mẫu
curl --fail-with-body https://api.baiyun.si/v1/models -H "Authorization: Bearer $BAIYUN_API_KEY"BAIYUN_API_KEY Đây là các biến môi trường bạn thiết lập riêng tại chỗ; không ghi giá trị thực vào hướng dẫn, kho mã hoặc ảnh chụp màn hình. 401 kiểm tra khóa trước, 404 kiểm tra địa chỉ trước, 429 chờ trước, không lặp lại quá trình này vô hạn.
Gửi lại yêu cầu văn bản tối thiểu
curl --no-buffer --fail-with-body https://api.baiyun.si/v1/chat/completions -H "Authorization: Bearer $BAIYUN_API_KEY" -H 'Content-Type: application/json' -d '{"model":"gpt-6-luna","messages":[{"role":"user","content":"你好"}],"stream":true}'Yêu cầu luồng trả về từng phân đoạn một. Việc liệt kê các mô hình không có nghĩa là thế hệ đã thành công; Tạo văn bản thông thường không có nghĩa là hình ảnh, âm thanh, tệp, tìm kiếm hay tất cả các công cụ đều có sẵn. Giữ thiết lập tối thiểu trước, sau đó bật từng chức năng một tùy theo diện tích mở thực tế của trang.
Tham số và ranh giới khả năng
Không tự động thêm máy khách toolsHình ảnh, tệp đính kèm hoặc trích dẫn lịch sử đều được xem là năng lực chung. Hiện tại, các kênh Codex có các bản chuyển thể riêng, nên khách hàng thông thường vẫn nên dùng văn bản thuần trước. Đường dẫn nén ngữ cảnh vẫn mở, nhưng dòng upstream trước đó đã trả về 404; Khi gặp lỗi này, bạn không thể sửa bằng cách thay đổi khóa liên tục.
Danh sách kiểm tra trước khi sử dụng thực tế
- 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.
- 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ố.
- 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ư.
- 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.
- 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.