Hướng dẫn API Baiyun: Giao diện văn bản phản hồi
Responses 同步与 SSE 流式文本请求及完整上下文说明。 附完整检查步骤、实操验证和错误处理。
Responses 文本接口
Địa chỉ giao diện:POST https://api.baiyun.si/v1/responses。
适合明确支持 Responses 协议的应用。当前可使用同步和 SSE 流式文本请求;完整接口的工具、文件、图像等扩展功能暂未开放。
同步文本请求
curl --fail-with-body https://api.baiyun.si/v1/responses \
-H "Authorization: Bearer $BAIYUN_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model":"gpt-6-luna",
"input":"请用一句话介绍你能帮我做什么。",
"stream":false
}'
响应中的 output 数组包含输出项。读取消息项 content 中 type 为 output_text 的 text 字段,并保留 usage 用量信息。不要假设原始 REST JSON 一定存在 SDK 提供的便利字段 output_text。
SSE 流式请求
curl --no-buffer --fail-with-body https://api.baiyun.si/v1/responses \
-H "Authorization: Bearer $BAIYUN_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"gpt-6-luna","input":"请写两句普通的问候语。","stream":true}'
按 SSE 事件类型解析:response.output_text.delta 提供文本增量;完整结束时应收到 response.completed。流未完成、出现失败事件或网络中断时,不应把已经显示的部分内容当成完整响应。
提交完整文本历史
{
"model": "gpt-6-luna",
"instructions": "用中文简短回答。",
"input": [
{"role": "user", "content": "什么是 Token?"},
{"role": "assistant", "content": "Token 是模型处理文本时使用的计量单位。"},
{"role": "user", "content": "它与字数完全相同吗?"}
],
"stream": false
}
当前应把必要上下文以文本随本次请求提交。引用上游会话的 previous_response_id、外部历史、工具调用或不可检查的媒体载荷暂不开放。
使用前核对
- 先通过带 Bearer 鉴权的
/v1/models核对实际模型名称。 - 当前仅开放文本模式,不支持任意 Responses 扩展字段或 SDK 自动附加的工具功能。
max_output_tokens等参数不是已保证的输出或费用硬上限;按实际用量和消费记录核对费用。- 每凭据最多 2 个并发请求;遇限流先等待,避免自动无限重试。
完整政策和暂未开放范围见本站使用规则;Chat 客户端查看Chat 文本接口。
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.