Lựa chọn giao thức
Chọn giao thức gọi mô hình ngôn ngữ phù hợp với ứng dụng hiện có và các khả năng cần giữ lại.
AGTCloud cung cấp nhiều giao thức gọi mô hình ngôn ngữ. Bạn có thể tiếp tục sử dụng SDK và cấu trúc yêu cầu của ứng dụng hiện có hoặc chọn một giao thức mới theo khả năng cần sử dụng.
Lần tích hợp đầu tiên: bắt đầu với OpenAI Chat
Nếu không có yêu cầu cụ thể về SDK hoặc giao thức, bạn có thể thực hiện lời gọi đầu tiên bằng OpenAI Chat Completions.
Giao thức gọi API là gì
Giao thức API quy định địa chỉ yêu cầu, phương thức xác thực, các trường yêu cầu, cấu trúc phản hồi và định dạng sự kiện luồng. Các giao thức sử dụng cấu trúc dữ liệu khác nhau; máy khách cần gửi yêu cầu và phân tích phản hồi theo giao thức đã chọn.
Trang này chỉ giới thiệu giao thức gọi mô hình ngôn ngữ, không bao gồm API hình ảnh, video và âm thanh.
Cách chọn giao thức
Giao thức quyết định cách tổ chức các trường yêu cầu, cấu trúc phản hồi và sự kiện luồng; mô hình quyết định khả năng AI thực tế. Bạn có thể lựa chọn theo thứ tự sau:
Giữ cách gọi của dự án hiện có
Dự án hiện có có thể tiếp tục sử dụng giao thức tương ứng với SDK hiện tại để giảm thay đổi đối với cấu trúc yêu cầu và cách phân tích phản hồi.
Xác định khả năng cần sử dụng
Nếu ứng dụng phụ thuộc vào cấu trúc nội dung, lời gọi công cụ, thông tin suy luận hoặc cách quản lý trạng thái cụ thể, hãy chọn giao thức có thể biểu diễn các trường đó.
Kiểm tra mô hình khả dụng
Truy cập Danh mục mô hình để xác nhận mô hình mục tiêu và quyền của tài khoản, sau đó thực hiện lời gọi theo API Reference tương ứng.
Các giao thức được hỗ trợ
| Giao thức | Trường hợp phù hợp | Cấu trúc chính | API Reference |
|---|---|---|---|
| OpenAI Chat Completions | Hội thoại thông thường hoặc ứng dụng OpenAI Chat hiện có | messages, choices | Chat Completions |
| OpenAI Responses | Ứng dụng sử dụng cấu trúc yêu cầu Responses | input, Response Items | OpenAI Responses |
| Anthropic Messages | Ứng dụng sử dụng Anthropic SDK hoặc cấu trúc Messages | messages, Content Blocks | Anthropic Messages |
| Gemini Generate Content | Ứng dụng sử dụng Gemini SDK hoặc cấu trúc Contents/Parts | contents, Parts | Gemini Generate Content |
Tên trường và cấu trúc phản hồi khác nhau giữa các giao thức. Máy khách cần tạo yêu cầu và phân tích phản hồi theo API Reference của giao thức đã chọn; không trộn trực tiếp các trường của những giao thức khác nhau.
Điểm truy cập API
Các URL gọi API dưới đây tự động cập nhật theo trang web hiện tại:
URL yêu cầu:
POST https://api.agtcloud.cn/v1/chat/completionsURL yêu cầu:
POST https://api.agtcloud.cn/v1/responsesURL yêu cầu:
POST https://api.agtcloud.cn/v1/messagesURL yêu cầu:
POST https://api.agtcloud.cn/v1beta/models/{model}:generateContent
Các tình huống thường gặp
- Dự án OpenAI Chat hiện có: chọn Chat Completions.
- Dự án OpenAI Responses hiện có: chọn OpenAI Responses.
- Dự án Anthropic SDK hiện có: chọn Anthropic Messages.
- Dự án Gemini SDK hiện có: chọn Gemini Generate Content.
- Chưa có cách gọi hiện tại: thực hiện lời gọi tối thiểu bằng Chat Completions trước.
AGTCloud hỗ trợ chuyển đổi giao thức, nhưng điều đó không có nghĩa là các tham số tương thích hoàn toàn 100%.
Kiểm tra trước khi tích hợp
- Kiểm tra ID mô hình và quyền tài khoản trong Danh mục mô hình.
- Kiểm tra điểm cuối, phương thức xác thực và các trường yêu cầu trong API Reference tương ứng.
- Xác minh các yêu cầu thông thường, đầu ra luồng hoặc lời gọi công cụ mà ứng dụng thực tế sử dụng trong môi trường thử nghiệm.