Hướng dẫn API Baiyun: Bắt đầu nhanh chóng
Từ việc đăng nhập, gửi và tạo khóa cho đến yêu cầu API văn bản thuần túy đầu tiên. Bao gồm các bước kiểm tra đầy đủ, xác minh thực tế và xử lý lỗi.
Bắt đầu thôi
Trang này giúp bạn bắt đầu sử dụng trang web từ chat website hoặc gọi API. Phạm vi dịch vụ hiện tại là:Yêu cầu toàn diện, có thể kiểm chứng。
Trải nghiệm trên trang web
- Đăng ký hoặc đăng nhập vào tài khoản trang này.
- Mở raVíSau khi xác nhận số tiền Doken (WordKnife, DK) và số tiền thanh toán RMB thực tế, nạp tiền qua Alipay hoặc WeChat; Giá đơn vị hiện tại là 0,30 RMB/DK.
- Mở raTrải nghiệm trò chuyệnChọn mô hình đang mở và trước tiên gửi một câu hỏi văn bản ngắn, bình thường.
- Tồn tạiBảng điều khiểnXem hồ sơ sử dụng và tiêu thụ.
Hiện tại, tiêu thụ dựa trên số dư; không cần đăng ký thành viên. Vui lòng đọc trước khi nạp lại hoặc gọi trận đấuQuy tắc sử dụng。
Tạo khóa gọi cho ứng dụng
Tồn tạiQuản lý khóaTạo khóa API cho các lệnh gọi mô hình; Thiết lập giới hạn cân bằng và mô hình theo nhu cầu thực tế, và lưu trữ đúng cách sau khi lưu lại.
Ứng dụng sử dụngKhóa gọi mô hình, không phải mật khẩu đăng nhập web. Không ghi khóa vào mã công khai, ảnh chụp màn hình, nội dung trò chuyện hoặc mã giao diện truy cập trên trình duyệt. Các khóa bị rò rỉ nên được thu hồi và tạo lại trong quản lý khóa.
Cấu hình máy khách
| Các mục cấu hình | Nội dung đã điền hiện tại |
|---|---|
| API Base URL | https://api.baiyun.si/v1 |
| API Key | Khóa gọi được tạo bởi quản lý khóa của trang web |
| Mô hình | Ví dụ, gpt-6-luna; Để biết danh sách chính xác, xem Mô hình Vuông |
| Giao diện | Chế độ văn bản cho Hoàn thành hoặc Phản hồi Trò chuyện |
Các khách hàng khác nhau định nghĩa địa chỉ khác nhau: điền vào Base URL Thông thường nó được giữ lại vào thời điểm đó /v1； Nếu bạn cần điền đầy đủ địa chỉ Chat, vui lòng điền https://api.baiyun.si/v1/chat/completions。 Đừng cất nó đi /v1 Lặp lại việc nối hai lần. Không phải tất cả các client, plugin và chức năng đều tương thích theo mặc định.
Yêu cầu API đầu tiên
Thiết lập biến môi trường trên thiết bị đầu cuối cục bộ để tránh vào màn hình chia sẻ hoặc màn hình ghi khi nhập khóa:
read -r -s -p '请输入本站 API 密钥：' BAIYUN_API_KEY
printf '\n'
export BAIYUN_API_KEY
curl --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": false
}'Yêu cầu thành công sẽ trả về văn bản được tạo và thông tin sử dụng, đồng thời trừ số dư DK khỏi giá đơn vị tham chiếu được liệt kê. 1 DK đề cập đến lô token có giá 1 USD theo các báo giá tham chiếu API thương mại được chọn, không phải số lượng token cố định hoặc tiền mặt có thể chuyển đổi sang đô la Mỹ. Các yêu cầu bình thường ở trên cũng tạo ra một lượng tiêu thụ nhỏ.
Giá nạp tiền hiện tại là 0,30 RMB/DK trên trang này, không phải chính xác giá đăng ký đã được kiểm tra thực tế; Giá trị tham chiếu và chi phí đăng ký cho cùng một lô token được hiển thị bằng quy đổi RMB hoặc JPYHướng dẫn thanh toán ba bước。
Nếu bạn muốn nhận đầu ra liên tục, hãy kiểm tra nóVí dụ về phát trực tiếp trò chuyện； Khi sử dụng Phản hồi, ứng dụng có thể xem nóVí dụ về phản hồi。
Kiểm tra các mô hình có thể gọi
Giao diện danh sách mô hình cũng yêu cầu xác thực khóa:
curl --fail-with-body https://api.baiyun.si/v1/models \
-H "Authorization: Bearer $BAIYUN_API_KEY"Mô hình thực sự trả về khóa hiện tại sẽ được ưu tiên. Nếu mô hình không tồn tại hoặc không khả dụng, vui lòng kiểm tra tên mô hình, giới hạn khóa và cân bằng, và không thử lại các yêu cầu không được hỗ trợ nhiều lần.
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.