Tích hợp kỹ thuật

Đổi endpoint, giữ lại cách gọi OpenAI quen thuộc

API tương thích giúp tái sử dụng SDK và cấu trúc request hiện có, nhưng model ID và mức tương thích từng endpoint vẫn phải được kiểm thử.

Ba giá trị cần thay đổi

Phần lớn ứng dụng chỉ cần thay base URL, API key và model ID. Không đặt khóa trong mã nguồn hoặc bundle trình duyệt. Dùng biến môi trường ở server và tạo khóa riêng cho từng ứng dụng để có thể thu hồi độc lập.

Tương thích không có nghĩa là giống hoàn toàn

Các endpoint chat completions thường có mức tương thích cao, nhưng Responses API, tool calling, JSON mode, hình ảnh và WebSocket có thể khác theo kênh. Chỉ bật một tính năng sau khi chạy test request và xác nhận response schema trong môi trường staging.

Chuẩn bị cho lỗi upstream

Đặt timeout, retry có exponential backoff và giới hạn số lần thử. Lưu request ID, model ID và mã lỗi, nhưng không ghi prompt nhạy cảm nếu không cần thiết. Với tác vụ quan trọng, benchmark một model dự phòng trước khi production.

Checklist trước khi quyết định

  • Base URL lấy từ bảng điều khiển
  • Model ID thuộc đúng nhóm
  • Streaming đã được test
  • Timeout và retry có giới hạn
  • Khóa chỉ tồn tại ở server

Câu hỏi thường gặp

Trả lời ngắn, có thể kiểm tra

Có dùng được OpenAI SDK chính thức không?

Có thể dùng với các endpoint tương thích bằng cách thay base URL và key. Tính năng nâng cao cần kiểm thử theo từng model và nhóm.

Tại sao model not found?

Kiểm tra model ID, nhóm gắn với khóa và danh sách model được mở trong Model Plaza.

Đọc tiếp

Nội dung liên quan

Bắt đầu với một khóa API

Tạo tài khoản, chọn nhóm mô hình và theo dõi mức sử dụng trong cùng một bảng điều khiển.

Tạo tài khoản