AI AssistantTrò chuyện

Send Chat Message

Gửi request đến ứng dụng trò chuyện.

Khi response_mode là blocking, trả về một ChatCompletionResponse. Khi response_mode là streaming, trả về luồng ChunkChatCompletionResponse.

Headers

X-Api-KeystringRequired

Request

This endpoint expects an object.
querystringRequired

Nội dung đầu vào/câu hỏi của người dùng.

userstringRequired

Định danh người dùng, dùng để xác định danh tính của người dùng cuối phục vụ cho việc tính toán thống kê và truy xuất. Nên được định nghĩa duy nhất bởi nhà phát triển trong ứng dụng.

inputsmap from strings to anyOptionalDefaults to {}

Cho phép nhập các giá trị biến do App định nghĩa. Tham số inputs chứa nhiều cặp key/value, với mỗi key tương ứng với một biến cụ thể và mỗi value là giá trị cụ thể cho biến đó.

response_modeenumOptional

Chế độ trả về phản hồi, hỗ trợ:

  • streaming Chế độ streaming (khuyên dùng), triển khai đầu ra trả về dạng gõ chữ thô thông qua SSE (Server-Sent Events).
  • blocking Chế độ blocking, trả về kết quả sau khi thực thi hoàn tất. (Các request có thể bị gián đoạn nếu quá trình diễn ra dài — do giới hạn của Cloudflare, request sẽ bị gián đoạn mà không có phản hồi sau 100 giây). Lưu ý: chế độ blocking không được hỗ trợ trong chế độ Agent Assistant.
conversation_idstring or nullOptional

ID trò chuyện, để tiếp tục cuộc trò chuyện dựa trên các bản ghi trước đó, cần truyền vào conversation_id của tin nhắn trước.

fileslist of objects or nullOptional
auto_generate_namebooleanOptionalDefaults to true

Tự động tạo tiêu đề, mặc định là true. Nếu đặt là false, có thể tạo tiêu đề bất đồng bộ bằng cách gọi API đổi tên trò chuyện và đặt auto_generate thành true.

Response

Khi `response_mode` là `blocking`, trả về `application/json` chứa `ChatCompletionResponse`. Khi `response_mode` là `streaming`, trả về `text/event-stream` — mỗi streaming chunk bắt đầu bằng `data:`, ngăn cách bởi hai ký tự xuống dòng `\n\n`.
message_idstring

ID duy nhất của tin nhắn.

conversation_idstring
modestring

Chế độ ứng dụng, cố định là chat.

answerstring

Nội dung phản hồi hoàn chỉnh.

metadataobject
created_atlong

Timestamp lúc tạo tin nhắn, VD: 1705395332.

Errors

400
Bad Request Error
404
Not Found Error
500
Internal Server Error