API Reference
Tìm AGTCloud API theo tác vụ phát triển và xem endpoint, tham số, phản hồi cùng công cụ thử API trực tuyến.
AGTCloud API Reference cung cấp địa chỉ yêu cầu, phương thức xác thực, Schema tham số, cấu trúc phản hồi, ví dụ mã và công cụ thử API trực tuyến cho từng API. Bạn có thể tìm API theo tác vụ trước, rồi mở trang endpoint cụ thể để xem đầy đủ các trường.
Gọi API lần đầu
Nếu chưa có API Key hoặc chưa xác định Base URL và ID mô hình, hãy đọc Bắt đầu nhanh trước. Nếu đã hoàn thành cấu hình cơ bản, bạn có thể chọn API cần dùng bên dưới.
Khả năng chính
Văn bản, hình ảnh và video là các mục chính hiện tại của API Reference. Một khả năng có thể cung cấp đồng thời định dạng tương thích OpenAI, định dạng của nhà cung cấp hoặc định dạng tác vụ bất đồng bộ AGTCloud. Hãy chọn theo SDK hiện có và mô hình mục tiêu.
Văn bản và hội thoại
Tạo văn bản và xử lý hội thoại nhiều lượt bằng Chat Completions, Responses, Anthropic Messages, Gemini Generate Content và các giao thức khác.
Tạo hình ảnh
Tạo, chỉnh sửa hoặc tạo biến thể hình ảnh; cũng có thể dùng API tác vụ bất đồng bộ Grok Image và Midjourney.
Tạo video
Tạo và truy vấn video qua Video Generations của nền tảng, OpenAI Videos và các mục Grok, Kling, Vidu.
API khác
Xử lý âm thanh
Tổng hợp giọng nói, phiên âm và dịch âm thanh, nhận dạng giọng nói bất đồng bộ và xử lý giọng.
Embeddings
Chuyển đầu vào văn bản hoặc Token thành vector để truy xuất ngữ nghĩa, phân cụm và tính độ tương đồng.
Rerank
Xếp hạng lại tài liệu ứng viên theo mức liên quan bằng định dạng Jina, Cohere hoặc Xinference.
Realtime
Xử lý văn bản, âm thanh và gọi hàm theo thời gian thực qua sự kiện WebSocket.
Chọn theo hình thức API
Các khả năng sử dụng hình thức truyền và cách lấy kết quả khác nhau. Phía máy khách cần xử lý dữ liệu theo Content-Type và loại phản hồi trên trang endpoint.
| Hình thức API | Tình huống phổ biến | Cách xử lý phía máy khách |
|---|---|---|
| JSON đồng bộ | Văn bản thông thường, Embedding, Rerank | Phân tích phản hồi JSON sau khi yêu cầu hoàn tất |
| Phản hồi SSE dạng luồng | Chat, Responses, Gemini dạng luồng | Đọc sự kiện liên tục đến khi luồng kết thúc |
| Tác vụ bất đồng bộ | Video, Midjourney | Lưu ID tác vụ và truy vấn trạng thái cùng kết quả |
| Tải lên Multipart | Chỉnh sửa hình ảnh, phiên âm âm thanh | Tải tệp và trường biểu mẫu theo yêu cầu của endpoint |
| Phản hồi nhị phân | Tải nội dung video hoặc âm thanh | Lưu tệp theo kiểu phương tiện của phản hồi |
| WebSocket | Realtime | Thiết lập kết nối dài hạn và liên tục gửi, nhận sự kiện |
Cách đọc trang endpoint
Xác nhận Endpoint và xác thực
Kiểm tra Method, Path, địa chỉ API và Header xác thực mà endpoint yêu cầu. Xem quy tắc chung trong Quy ước chung.
Chọn tình huống yêu cầu
Chọn ví dụ gần với tác vụ hiện tại nhất, rồi điều chỉnh các trường theo Request Body, Path Parameters hoặc Query Parameters.
Kiểm tra phản hồi và lỗi
Phân tích kết quả theo trạng thái HTTP và kiểu phương tiện phản hồi. Khi thất bại, lưu thông tin lỗi đã che dữ liệu nhạy cảm và Request ID nếu có trong phản hồi, rồi xem Lỗi và khắc phục sự cố.
Kiểm tra bằng Try It
Công cụ thử API trực tuyến dùng địa chỉ API hiển thị trên trang này. Nhập API Key của tài khoản hiện tại và chọn mô hình khả dụng từ danh sách mô hình. Không dùng Key dài hạn của môi trường production trên thiết bị dùng chung.
Quy tắc chung trước khi tích hợp
- Nếu chưa biết nên dùng giao thức văn bản nào, hãy đọc Chọn giao thức trước.
- Thay
MODEL_IDtrong ví dụ Reference bằng ID mô hình thực sự khả dụng với API Key hiện tại. - Các khả năng cùng tên có thể hỗ trợ trường khác nhau tùy mô hình và giao thức; căn cứ vào endpoint hiện tại, quyền tài khoản và phản hồi thực tế.
- Ứng dụng production không được mã hóa cứng API Key trong trình duyệt hoặc gói ứng dụng phía máy khách. Try It chỉ dùng để thử tạm thời; không ghi Key vào kho mã công khai, ảnh chụp màn hình hoặc log.
Đọc tiếp: Quy ước chung · API Key, Base URL và xác thực