Ví dụ về việc hoàn thành trò chuyện đồng bộ với luồng SSE, yêu cầu văn bản thuần túy. Bao gồm các bước kiểm tra đầy đủ, xác minh thực tế và xử lý lỗi.

Giao diện văn bản Hoàn thành Trò chuyện

Địa chỉ giao diện:POST https://api.baiyun.si/v1/chat/completions。

Hiện tại, các cuộc trò chuyện văn bản thuần theo kiểu Chat đã có sẵn cho các khách hàng hỗ trợ rõ ràng giao thức Chat của OpenAI. Yêu cầu sử dụng khóa trang web và gửi toàn bộ ngữ cảnh cần thiết cho cuộc trò chuyện này.

Cấu trúc yêu cầu

{
  "model": "gpt-6-luna",
  "messages": [
    {"role": "system", "content": "用简洁的中文回答。"},
    {"role": "user", "content": "请解释什么是 Token。"}
  ],
  "stream": false
}

model Đây là tên của mẫu xe thực sự có trên trang web này;messages Tin nhắn văn bản được gửi theo thứ tự;stream Quyết định trả về đồng bộ hay phát trực tiếp. Bài viết này chỉ trình bày cấu trúc văn bản cơ bản mở; các tham số SDK phức tạp và các tính năng mở rộng không nên có sẵn theo mặc định.

Cuộc gọi đồng bộ

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":"用一句话解释 Token。"}],"stream":false}'

Văn bản được tạo ra nằm tại choices[].message.content； Thông tin về liều lượng được tìm thấy tại đây usage。 Nội dung cụ thể, số lượng token và phí sẽ phụ thuộc vào phản hồi và hồ sơ tiêu thụ thực tế của thời điểm này.

Các cuộc gọi phát trực tuyến

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":"用三句话介绍 Token。"}],
    "stream":true,
    "stream_options":{"include_usage":true}
  }'

Luồng trả về bằng SSE: đọc data: JSON, nối chúng lại theo thứ tự choices[].delta.content。data: [DONE] Chỉ ra kết thúc luồng; Đã kích hoạt include_usage Thông báo sử dụng ở cuối phải được giữ lại sau đó. Đừng xem mọi shard SSE như một phản hồi HTTP độc lập.

Ngữ cảnh đối thoại và ranh giới tham số

Kênh hiện tại sử dụng lấy mẫu mặc định của mô hình.temperature、top_p、frequency_penalty Và presence_penalty Hiện tại chưa có các nút điều chỉnh điều chỉnh; Các giá trị mặc định phổ biến ở phía khách hàng sẽ bị loại bỏ bởi xử lý tương thích và không thay đổi thiết lập lấy mẫu của mô hình.

Cần có nhiều vòng đối thoại messages Gửi lịch sử văn bản đầy đủ theo yêu cầu. Hiện tại, các công cụ bên ngoài, mạng, hình ảnh và chức năng tệp đều bị tạm ngưng, và không có cách nào để bỏ qua việc gửi văn bản thông qua lịch sử bên ngoài không được kiểm tra.

Một số mẫu hoặc thiết bị hỗ trợ các tham số đầu ra khác nhau. Ngay cả khi bạn yêu cầu điền vào max_tokens、max_completion_tokens Hoặc các giá trị như 8192, v.vNó không thể được coi là chiều dài sản lượng cố định hoặc giới hạn chi phí được đảm bảo bởi địa điểm này。 Bắt đầu bằng một yêu cầu ngắn, kiểm tra hồ sơ chi tiêu và đặt giới hạn số dư cho các khóa phù hợp với bạn.

Cùng một phiếu quà tặng có thể được xử lý cùng lúc tối đa 2 yêu cầu； Các cuộc gọi mô hình cũng bị giới hạn bởi tần suất. Nếu bạn gặp 429, hãy chờ và nhấn nóTuyên bố saiXác định nguyên nhân và tránh thử lại vòng lặp tần số cao.

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.