FAQ

Làm theo Bắt đầu nhanh để đăng nhập, tạo API Key, chọn mô hình và gửi yêu cầu tối thiểu. Lần thử đầu nên dùng API tương thích OpenAI Chat; sau khi xác nhận luồng cơ bản hoạt động, mới thêm đầu ra theo luồng, gọi công cụ hoặc đầu vào đa phương thức.

Mở API Keys để tạo, vô hiệu hóa hoặc xóa token truy cập. Nên dùng Key khác nhau cho từng môi trường; vô hiệu hóa hoặc xóa ngay Key không còn dùng hoặc nghi bị lộ.

Base URL được khuyến nghị là https://api.agtcloud.cn/v1. Khi dùng OpenAI SDK, đặt trong base_url hoặc baseURL; API tương thích OpenAI thường xác thực bằng Authorization: Bearer your-api-key. Giao thức khác dùng Header xác thực theo API Reference tương ứng. Xem chi tiết tại API Key, Base URL và xác thực.

Không nên. API Key dài hạn cần được lưu trên máy chủ đáng tin cậy, trong biến môi trường phía máy chủ hoặc dịch vụ quản lý khóa. Trình duyệt và ứng dụng di động nên gọi backend của bạn, rồi backend gọi AGTCloud để tránh người dùng lấy và lạm dụng Key.

Nguyên nhân thường là Base URL đã chứa /v1 nhưng mã lại thêm /v1 trước endpoint. Nên dùng https://api.agtcloud.cn/v1 làm SDK Base URL và để SDK tự nối endpoint như /chat/completions. Khi khắc phục sự cố, kiểm tra URL đầy đủ thực sự được gửi.

Mở Danh mục mô hình để xem các mô hình và ID đang được hiển thị. Phạm vi mô hình khả dụng thay đổi theo cấu hình nền tảng và quyền tài khoản; sao chép ID đang hiển thị khi gọi và dựa vào kết quả yêu cầu thực tế.

Nếu không cần giữ ngữ nghĩa riêng của giao thức nhà cung cấp, có thể bắt đầu với OpenAI Chat Completions vì SDK và cách tích hợp phổ biến. Với ứng dụng Anthropic, Gemini hoặc Responses có sẵn, ưu tiên giữ SDK và cấu trúc thông điệp hiện tại rồi kiểm tra khả năng tương thích của mô hình mục tiêu.

Với 401, kiểm tra Header xác thực theo giao thức và API Key trước; với 403, kiểm tra tài khoản, Key và quyền mô hình; với 404, kiểm tra Base URL, endpoint, ID mô hình hoặc ID tác vụ. Không thử lại vô hạn; sửa nguyên nhân rõ ràng trước. Xem thêm tại Lỗi và khắc phục sự cố.

Kiểm tra x-request-id, request-id hoặc x-oneapi-request-id trong Header phản hồi và lưu giá trị thực sự có. Nội dung lỗi cũng có thể chứa Request ID; nếu không tìm thấy, vẫn ghi thời gian yêu cầu, Method, Path, mô hình và trạng thái HTTP. Xem ví dụ mã tại Request ID.

Mở ngay API Keys để vô hiệu hóa hoặc xóa Key cũ, tạo Key mới và cập nhật các dịch vụ sử dụng. Kiểm tra bản sao trong kho mã, nhật ký, ảnh chụp và lịch sử trò chuyện; nếu từng đưa vào Git, không chỉ xóa tệp hiện tại mà còn xử lý lịch sử theo quy trình bảo mật của nhóm.

Chuẩn bị thời gian và múi giờ yêu cầu, Method, Path, ID mô hình, trạng thái HTTP, lỗi đã che dữ liệu nhạy cảm, phiên bản SDK và runtime, cùng bước tái hiện tối thiểu. Lưu kèm Request ID nếu phản hồi có. Không gửi API Key đầy đủ, Header xác thực, Cookie, Prompt khách hàng hoặc tệp riêng.