Tạo khóa gọi, cô lập mục đích, giới hạn mô hình và thu hồi các khóa bị rò rỉ. Bao gồm các bước kiểm tra đầy đủ, xác minh thực tế và xử lý lỗi.

Tạo và bảo mật khóa API

Đầu tiên, hoàn thành tài khoản

Tồn tạiĐăng ký và đăng nhậpHoàn thành mã xác minh email, mật khẩu đăng nhập và thông tin tài khoản. Các tài khoản được ủy quyền QQ / Alipay có Imperfect phải hoàn thành các bước này trước khi gọi mô hình và nạp tiền.

Tạo khóa gọi

1. Mở raQuản lý khóa, chọn để tạo khóa.
2. Tên gọi thể hiện rõ mục đích, chẳng hạn như "Personal Cherry Studio" hoặc "Project Development Environment."
3. Thiết lập thời gian hiệu lực, giới hạn khả dụng và giới hạn mô hình dựa trên các tùy chọn thực tế trên trang; Khi sử dụng nhóm mặc định, bạn không cần phải tự tìm các tuyến ẩn thủ công.
4. Sau khi lưu, sao chép khóa vào trình quản lý mật khẩu hoặc ứng dụng của bạn. Không sử dụng mật khẩu đăng nhập web hoặc token quản lý backend thay thế.
5. Ứng dụngBắt đầu thôiMột yêu cầu xác nhận ngắn gọn. Số dư tiêu dùng thực tế được tạo ra.

Mỗi lần sử dụng đều có một khóa riêng biệt

Các khóa được tạo riêng biệt cho máy khách máy tính, dự án máy chủ và các thí nghiệm tạm thời, giúp dễ dàng phân biệt các mục đích sử dụng trong nhật ký và thu hồi từng lần riêng lẻ. Giới hạn của mẫu chỉ nằm trong phạm vi có thể gọi và không làm tăng số dư tài khoản; Cả hạn mức khóa và số dư tài khoản còn lại đều nên đủ.

Khi chìa khóa bị rò rỉ

Ngay lập tức thu hồi khóa cũ trong quản lý khóa, tạo khóa mới, cập nhật máy khách và kiểm tra hồ sơ sử dụng gần đây. Chỉ xóa ảnh chụp màn hình công khai hoặc tệp Git không thu hồi các khóa đã bị rò rỉ. Không gửi toàn bộ khóa cho dịch vụ khách hàng; Cung cấp mã lỗi, thời gian và thông tin yêu cầu đã giảm nhạy cảm.

Xác minh địa chỉ

URL cơ sở là https://api.baiyun.si/v1。 Địa chỉ Chat đầy đủ là https://api.baiyun.si/v1/chat/completions； Địa chỉ đầy đủ của Phản hồi là https://api.baiyun.si/v1/responses。 Điền ô nào phụ thuộc vào ý nghĩa của trường phía khách hàng; đừng viết rõ /v1/v1。

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: Những phiếu nào không nên trộn lẫn

Mật khẩu đăng nhập chỉ dùng cho đăng nhập tài khoản, và khóa gọi model chỉ dùng cho các yêu cầu model /v1. Các phiên PAT/Bảng điều khiển quản lý backend có quyền quản lý và không thể tích hợp vào các máy khách thông thường. Chia sẻ cùng một khóa giữa nhiều người có thể gây nhầm lẫn giữa nhật ký và hạn ngạch truy cập, ưu tiên tạo một khóa duy nhất cho từng thiết bị hoặc dự án.

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.