Cách tích hợp OpenAI API vào ứng dụng của bạn

Để tích hợp OpenAI API, hãy tạo API key trong một project của OpenAI, lưu nó như một secret phía máy chủ tên OPENAI_API_KEY, và gọi API từ một route trên máy chủ của bạn bằng SDK chính thức của OpenAI, không bao giờ từ mã chạy trên trình duyệt. Tính đến tháng 9/2026, hướng dẫn bắt đầu nhanh của OpenAI giới thiệu Responses API là điểm khởi đầu cho các project mới. Hãy đặt giới hạn chi tiêu trước khi ra mắt, giới hạn độ dài câu trả lời, hạn chế tần suất mỗi người dùng có thể gọi tính năng, và xử lý lỗi giới hạn tốc độ bằng cách thử lại.

Hướng dẫn này bao gồm thiết lập, luồng yêu cầu, prompt cho một AI builder, và những sai lầm làm rò rỉ key hoặc đốt tiền. Thông tin về OpenAI được lấy từ tài liệu chính thức tính đến tháng 9/2026. Với các khái niệm chung (token, cửa sổ ngữ cảnh, giá), hãy đọc trước cách sử dụng LLM API.

Bạn có thể xây dựng gì với nó

• Một trợ lý chat trong ứng dụng (cách xây dựng ứng dụng chatbot AI)
• Các nút "Tóm tắt cái này", "viết lại cái này" hoặc "soạn câu trả lời"
• Trích xuất dữ liệu có cấu trúc từ văn bản tự do: biến email thành đơn hàng, gắn nhãn cho ticket hỗ trợ
• Tìm kiếm và trả lời câu hỏi dựa trên nội dung của riêng bạn
• Tạo hình ảnh, giọng nói và các tính năng media khác, tùy theo model hiện có

Thêm ý tưởng có trong cách thêm tính năng AI vào ứng dụng.

Thiết lập tài khoản OpenAI

1. Tạo tài khoản và một project trên nền tảng OpenAI. Các thực hành tốt nhất cho production của OpenAI khuyên tách project cho staging và production, để mỗi bên có key và giới hạn riêng.
2. Tạo API key cho project. OpenAI khuyên đặt ngày hết hạn và thay key định kỳ.
3. Đặt cảnh báo chi tiêu và giới hạn chi tiêu cứng trên trang limits. Hướng dẫn của OpenAI cho biết cảnh báo sẽ báo cho bạn khi mức sử dụng vượt một số tiền, còn giới hạn cứng sẽ áp dụng mức trần hàng tháng.
4. Thêm phương thức thanh toán. Tài liệu giới hạn tốc độ của OpenAI mô tả các bậc sử dụng: giới hạn của bạn tự động tăng khi bạn chi tiêu nhiều hơn theo thời gian.

Luồng yêu cầu

Trình duyệt  ->  route máy chủ của bạn  ->  OpenAI API
            <-  (câu trả lời stream)   <-

1. Người dùng nhấn một nút hoặc gửi tin nhắn.
2. Trình duyệt gọi route của bạn, ví dụ POST /api/summarise.
3. Máy chủ của bạn kiểm tra người dùng đã đăng nhập và được phép dùng tính năng này.
4. Máy chủ xây dựng yêu cầu: chỉ dẫn, đầu vào của người dùng, và mọi dữ liệu từ cơ sở dữ liệu mà tác vụ cần.
5. Nó gọi OpenAI với key lấy từ biến môi trường. SDK của OpenAI tự động đọc OPENAI_API_KEY.
6. Nó stream hoặc trả về câu trả lời, và ghi lại mức sử dụng token.

Gói SDK chính thức của OpenAI có tên openai, dùng cho cả JavaScript/TypeScript (npm) và Python (pip).

Chọn model

OpenAI cung cấp nhiều model với giá và tốc độ khác nhau, và danh sách này thay đổi thường xuyên. Hãy bắt đầu với một model nhỏ hơn, rẻ hơn, đo chất lượng trên các ví dụ thực tế, và chỉ nâng cấp khi thực sự cần. Giữ tên model trong một giá trị cấu hình hoặc secret để có thể đổi mà không phải viết lại mã. Xem trang giá của OpenAI để biết mức giá hiện tại.

Lựa chọn và đánh đổi

Prompt để đưa cho AI builder của bạn

Một tính năng đầu tiên:

Thêm nút "Tóm tắt" trên trang ticket. Nút này gọi một route máy chủ POST /api/summarise, route này kiểm tra người dùng đã đăng nhập, tải ticket và gọi OpenAI Responses API bằng SDK chính thức openai và secret OPENAI_API_KEY. Đọc tên model từ secret OPENAI_MODEL. Chỉ dẫn: "Tóm tắt trong 3 gạch đầu dòng, sau đó đề xuất một câu trả lời ngắn. Không bịa ra số đơn hàng." Giới hạn độ dài đầu ra, stream câu trả lời lên trang, và không bao giờ gửi key cho trình duyệt.

Rào chắn:

Giới hạn mỗi người dùng 30 yêu cầu AI mỗi giờ, lưu trong cơ sở dữ liệu. Ghi lại số token đầu vào và đầu ra của mỗi yêu cầu cùng với ID người dùng và tên tính năng. Nếu OpenAI trả về 429, tôn trọng header Retry-After và thử lại với exponential backoff và jitter tối đa 3 lần; sau đó hiển thị "AI đang bận, vui lòng thử lại sau một phút." Hiển thị thông báo lỗi thân thiện cho mọi lỗi khác và giữ cho phần còn lại của trang hoạt động bình thường.

Xử lý lỗi và giới hạn

OpenAI đo giới hạn tốc độ theo nhiều cách, gồm số yêu cầu mỗi phút và số token mỗi phút, và bạn sẽ chạm vào giới hạn nào hết trước. Khi vượt một giới hạn, API trả về 429 kèm header Retry-After. Tài liệu của OpenAI yêu cầu coi giá trị này là mức tối thiểu và thêm một độ trễ ngẫu nhiên nhỏ để các client không cùng thử lại một lúc.

Cũng cần lên kế hoạch cho:

• Timeout với các lần sinh nội dung dài. Streaming giúp ích, và giới hạn đầu ra hợp lý cũng vậy.
• Sự cố của nhà cung cấp. Tính năng AI nên thất bại một cách êm ái mà không làm hỏng trang.
• Đầu ra kém chất lượng. Kiểm tra đầu ra có cấu trúc trước khi lưu, và không để đầu ra của model kích hoạt hành động nhạy cảm nếu không có kiểm tra trong mã của bạn.

Lỗi thường gặp

• Key trong frontend hoặc trong repository. Mã trình duyệt là công khai, và key bị lộ có thể bị lạm dụng trong vài phút. Xem cách giữ API key an toàn.
• Không có giới hạn chi tiêu. Một vòng lặp hoặc người dùng lạm dụng có thể làm hóa đơn tăng nhanh chóng.
• Không có giới hạn theo người dùng. Giới hạn của nhà cung cấp bảo vệ ví của bạn, không bảo vệ những người dùng khác.
• Tin vào prompt để đảm bảo bảo mật. Người dùng có thể gõ "bỏ qua các chỉ dẫn trước đó". Quyền truy cập nên nằm trong mã phía máy chủ.
• Gửi nhiều hơn mức cần thiết. Toàn bộ tài liệu và lịch sử dài sẽ nhân chi phí lên. Chỉ gửi những gì tác vụ cần.
• Gắn cứng tên model. Model được cập nhật và ngừng hỗ trợ; hãy biến nó thành một cài đặt.
• Gửi dữ liệu cá nhân mà không suy nghĩ. Đọc điều khoản sử dụng dữ liệu của OpenAI và chỉ gửi những gì tính năng cần.

Danh sách kiểm tra

• Tách project OpenAI (hoặc key) cho thử nghiệm và production
• Key được lưu dưới dạng secret phía máy chủ, không bao giờ nằm trong mã trình duyệt hoặc repo
• Đã đặt cảnh báo chi tiêu và giới hạn chi tiêu cứng
• Mọi lệnh gọi đều đi qua máy chủ của bạn và kiểm tra quyền của người dùng
• Đã giới hạn độ dài đầu ra; tên model có thể cấu hình
• Có giới hạn tốc độ theo người dùng trong ứng dụng
• Xử lý 429 với Retry-After, backoff và jitter
• Có trạng thái lỗi thân thiện; trang vẫn hoạt động khi không có AI
• Ghi lại mức sử dụng token theo từng tính năng
• Đã thử với đầu vào dài, rỗng và độc hại

Dùng OpenAI API trong Mythex

Các tính năng AI trong ứng dụng bạn xây dựng trên Mythex dùng key OpenAI riêng của bạn, được tính phí vào tài khoản OpenAI của bạn chứ không phải vào tín dụng xây dựng của Mythex. Thêm OPENAI_API_KEY làm secret của dự án thông qua /secrets, cài đặt dự án hoặc thẻ secrets mà agent hiển thị khi cần key, rồi mô tả tính năng bằng một prompt tương tự như trên. Sau khi thay đổi secret trên một ứng dụng đã xuất bản, hãy xuất bản lại để ứng dụng nhận các giá trị mới. Công thức trong tài liệu Thêm tính năng AI bằng API key của riêng bạn có một prompt khởi đầu, và Secrets trong chat giải thích thẻ secrets. Đang so sánh các nhà cung cấp? Xem cách tích hợp Claude API.

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