Hướng dẫn tích hợp API

Hướng dẫn API Baiyun: Python, Node.js và LangChain

Đội ngũ biên tập Baiyun SI2026-10-09Khoảng 6 phút để đọc

Các biến môi trường phía máy chủ, ví dụ tối thiểu về Responses/Chat SDK và các lần thử lại. Bao gồm các bước kiểm tra đầy đủ, xác minh thực tế và xử lý lỗi.

Python, Node.js và LangChain

Máy chủ lưu khóa

Khóa đi qua các biến môi trường quy trình BAIYUN_API_KEY Đọc đi. Các trang web trình duyệt và ứng dụng di động không thể có khóa chia sẻ tích hợp; Bạn cần có xác thực backend riêng và chỉ tiêu để gửi yêu cầu thay bạn. Trước khi triển khai, kiểm tra xem nhật ký có in tiêu đề yêu cầu hay biến môi trường hay không.

Python

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["BAIYUN_API_KEY"],
                base_url="https://api.baiyun.si/v1",
                timeout=120.0, max_retries=0)
response = client.responses.create(model="gpt-6-luna",
                                   input="用一句话说明 Token 是什么。")
print(response.output_text)

output_text Đó là sự tiện lợi mà SDK mang lại; Khi phân tích trực tiếp REST JSON, nó nên được duyệt qua output Trường văn bản trong mục tin nhắn. Các phụ thuộc nên được cài đặt trong môi trường cách ly và giữ lại các tệp khóa dự án; Đừng nâng cấp toàn bộ dự án sản xuất chỉ để kiểm thử.

Node.js

import OpenAI from 'openai';
const client = new OpenAI({
  apiKey: process.env.BAIYUN_API_KEY,
  baseURL: 'https://api.baiyun.si/v1',
  maxRetries: 0,
  timeout: 120000,
});
const stream = await client.chat.completions.create({
  model: 'gpt-6-luna', stream: true,
  messages: [{role: 'user', content: '你好'}],
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
}

LangChain

Sử dụng bộ điều hợp mô hình hỗ trợ địa chỉ tương thích OpenAI, và thiết lập API Key, URL cơ sở và mô hình ở phiên bản hiện tại. Đầu tiên gọi văn bản thuần túy, sau đó thêm liên kết, truy xuất hoặc công cụ; Bất kỳ tham số bổ sung nào được framework tự động thêm vào vẫn phải tuân thủ phạm vi mở của trang web; không coi tên framework là đảm bảo về sự tương thích.

Lỗi và thử lại

Đầu tiên, phân biệt giữa lỗi trạng thái HTTP, lỗi cú pháp SDK và lỗi trả về kinh doanh. Các ngắt tạo có thể đã tiêu tốn tiền; đừng tự động thử lại vô hạn; 429 Thu hồi theo yêu cầu, 401 Thông tin xác thực sửa chữa, 400 tham số sửa chữa. Khi kết nối hết thời gian, hãy kiểm tra trang trạng thái và mạng trước khi quyết định có thử lại hay không.

Dự án SDK Python chính thức · Dự án SDK Node chính thức · Tài liệu chính thức của LangChain

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.

Khắc phục sự cố chi tiết: Phân biệt các vấn đề yêu cầu với các vấn đề mã nguồn

Đầu tiên, chạy curl tối thiểu với cùng khóa và mô hình, sau đó so sánh địa chỉ thực tế của SDK, giao thức yêu cầu và các tham số. Nếu curl thành công nhưng SDK thất bại, hãy khắc phục sự cố môi trường proxy, tự động thử lại SDK, hết thời gian chờ và các trường bổ sung. Không in quyền trong nhật ký lỗi; Khóa trong quá trình triển khai không thể ghi vào các biến build frontend.

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.

Quay lại cộng đồng và tiếp tục đọc Chia sẻ trải nghiệm của tôi