Skip to main content
Trang này trình bày các quy tắc chung cho mọi lời gọi mô hình. Dùng tài liệu API Apifox để xem schema yêu cầu/phản hồi đầy đủ; tài liệu này giải thích nên chọn giao thức nào và bắt đầu an toàn ra sao.
Hãy xác nhận khả năng trướcMô hình khả dụng thay đổi theo nhóm API Key, giới hạn mô hình và trạng thái dịch vụ thực tế. Danh sách toàn bộ trong Chợ mô hình không bảo đảm một key cụ thể có thể gọi mọi mô hình.

​
Ba giá trị bắt buộc

Với client theo kiểu OpenAI, dùng:
Khi tự gửi HTTP, truyền key trong Authorization:
Không đưa key đầy đủ vào frontend, ảnh chụp, lịch sử chat hoặc Git. Quy tắc URL thay đổi theo client: Claude Code dùng địa chỉ không có /v1, Codex CLI dùng cấu hình Provider. Hãy theo hướng dẫn công cụ client tương ứng.

​
Liệt kê mô hình mà key hiện tại nhìn thấy

Sao chép model ID từ data[].id. Đây là danh sách mô hình hiện nhìn thấy bởi key đó, không phải toàn bộ danh mục. Nếu phản hồi có supported_endpoint_types, trường này giúp nhận biết loại giao thức được ghi cho mô hình.

​
Chọn đúng giao thức

Cùng một tên mô hình không có nghĩa là mọi định dạng yêu cầu đều được chấp nhận. Xác nhận trong ma trận khả năng, sau đó đọc:

​
Kiểm tra tối thiểu và thử lại

  1. Liệt kê mô hình, sau đó gửi một yêu cầu văn bản ngắn hoặc tạo ảnh tối thiểu.
  2. Xác nhận model ID, nhóm key và đường dẫn trước khi thêm trường tùy chọn, stream hoặc tác vụ hàng loạt.
  3. Khi lỗi, lưu nội dung lỗi, thời điểm và Request ID. Không gửi lại một yêu cầu chưa rõ kết quả với tần suất cao.
Với 401, kiểm tra key trước. Với 404, kiểm tra /v1 bị thiếu hoặc lặp. Với 400, kiểm tra mô hình, giao thức và trường. Xem tự kiểm tra để biết thêm.