Trò chuyện dựa trên tìm kiếm của Felo
Nhà cung cấp: Felo · Thanh toán bằng số dư nền tảng
Gửi một câu hỏi và nhận về một câu trả lời được tạo cùng các nguồn web trong một phản hồi.
Tất cả ví dụ dùng FELO_API_KEY từ tổng quan. Các cuộc gọi sử dụng số dư nền tảng, không phải tín dụng Felo Pro. Các ví dụ phản hồi chỉ mang tính minh họa; nội dung thực tế và các trường tùy chọn sẽ thay đổi.
Endpoint
POST /api/v1/data/chat
Đây là endpoint dùng số dư nền tảng. Felo Search API tại /v2/chat dùng tín dụng Pro và có khung phản hồi khác.
Yêu cầu
| Trường | Kiểu | Bắt buộc | Ý nghĩa |
|---|---|---|---|
query | string | Có | Câu hỏi, 1–2.000 ký tự |
accept_language | string | Không | Ngôn ngữ trả lời ưu tiên, như en, ja, hoặc zh-CN; tối đa 64 ký tự |
stream | boolean | Không | Phải là false; mặc định là false |
Dùng thẻ ngôn ngữ với mã ngôn ngữ 2–8 chữ cái và các phân nhóm tùy chọn nối bằng dấu gạch ngang, như zh-TW. Dịch vụ sẽ thêm tùy chọn này vào yêu cầu tạo. Nếu bỏ qua, dịch vụ upstream sẽ tự chọn ngôn ngữ; không có giá trị mặc định cố định, và câu hỏi bằng tiếng Anh không đảm bảo câu trả lời bằng tiếng Anh. Tùy chọn này áp dụng cho câu trả lời được tạo; tiêu đề nguồn và trích đoạn giữ nguyên ngôn ngữ gốc.
Endpoint này trả về JSON không streaming. Nó không hỗ trợ stream: true, SSE, mảng messages hoặc chọn model.
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/chat" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Explain retrieval augmented generation and cite sources.","accept_language":"en","stream":false}'Phản hồi
HTTP 200 trả về status: "ok" và một đối tượng data:
{
"status": "ok",
"data": {
"id": "example-chat-id",
"message_id": "example-message-id",
"answer": "Retrieval augmented generation adds retrieved context to a model request...",
"resources": [
{"title":"Example reference","link":"https://example.com/guide","snippet":"An overview of retrieval augmented generation."}
],
"query_analysis": {"queries":["retrieval augmented generation"]}
}
}| Trường | Ý nghĩa |
|---|---|
data.answer | Câu trả lời được tạo |
data.resources | Các trang nguồn với tiêu đề, liên kết và đoạn trích |
data.query_analysis | Phân tích truy vấn tùy chọn; có thể là null |
data.id, data.message_id | Định danh phản hồi |
Kiểm tra trạng thái HTTP trước, rồi đọc câu trả lời và nguồn. Đừng kiểm tra status: 200 dạng số như bạn có thể làm với /v2/chat.
Thanh toán
chat được tính phí theo từng yêu cầu, không theo token của model. Xem giá hiện tại và Thanh toán và Lỗi.