Giới thiệu

OpenAI vừa ra mắt Responses API cho phép người dùng tạo phản hồi từ mô hình của họ. API này hỗ trợ cả đầu vào văn bản và hình ảnh, giúp tạo ra các đầu ra tương ứng. Người dùng có thể tích hợp mã tùy chỉnh của riêng mình hoặc sử dụng các công cụ tích hợp sẵn như tìm kiếm web và tìm kiếm tài liệu.

Bài viết này sẽ hướng dẫn bạn cách sử dụng OpenAI Responses API, giúp bạn khai thác tối đa tính năng mà OpenAI cung cấp.

Cách Đăng Ký Sử Dụng OpenAI Responses API

Để bắt đầu sử dụng OpenAI Responses API, bạn cần đăng ký và lấy chứng chỉ truy cập. Các bước thực hiện như sau:

• Truy cập trang OpenAI Responses API.
• Nhấn nút Acquire để lấy chứng chỉ.
• Nếu bạn chưa đăng nhập, hệ thống sẽ chuyển bạn đến trang đăng nhập. Đăng nhập hoặc đăng ký tài khoản để quay lại trang API.

Khi đăng ký lần đầu tiên, bạn sẽ nhận được một hạn mức sử dụng miễn phí.

Cách Sử Dụng Cơ Bản

Sau khi có chứng chỉ, bạn có thể thực hiện các bước sau để gửi yêu cầu tới API:

1. Chọn Authorization từ danh sách thả xuống.
2. Chọn loại mô hình từ danh sách có sẵn (hiện tại có 20 mô hình để lựa chọn).
3. Nhập input là mảng câu hỏi mà bạn muốn gửi tới mô hình, bao gồm hai trường là role và content:
   • role: xác định vai trò của người hỏi, có thể là user, assistant, hoặc system.
   • content: nội dung câu hỏi cụ thể của bạn.

Dưới đây là một ví dụ về mã gọi API:

import requests

url = "https://api.acedata.cloud/openai/responses"

headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" }

payload = { "model": "gpt-4.1", "input": [{"role":"user","content":"Xin chào"}] }

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Khi thực hiện yêu cầu này, bạn sẽ nhận được một phản hồi dạng JSON với nhiều trường khác nhau:

• id: ID của yêu cầu.
• model: Loại mô hình mà bạn đã chọn.
• output: Nội dung phản hồi từ mô hình.
• usage: Thông tin về lượng token đã sử dụng trong yêu cầu.

Tính Năng Phản Hồi Theo Dòng

API cũng hỗ trợ tính năng phản hồi theo dòng, cho phép hiển thị từng từ một trên trang web. Để sử dụng tính năng này, bạn cần thiết lập tham số stream trong yêu cầu:

payload = { "model": "gpt-4.1", "input": [{"role":"user","content":"Xin chào"}], "stream": True }

Khi bạn gọi API với stream là true, dữ liệu JSON sẽ được trả về từng dòng một. Đảm bảo rằng mã của bạn đã được điều chỉnh để xử lý các kết quả theo dòng.

Ví dụ mã Python cho phản hồi theo dòng

import requests

url = "https://api.acedata.cloud/openai/responses"

headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" }

payload = { "model": "gpt-4.1", "input": [{"role":"user","content":"Xin chào"}], "stream": True }

response = requests.post(url, json=payload, headers=headers)

for line in response.iter_lines():
    if line:
        print(line)

Thực Hiện Đối Thoại Nhiều Lượt

Để thực hiện đối thoại nhiều lượt, bạn chỉ cần gửi nhiều câu hỏi trong mảng input:

payload = { "model": "gpt-4.1", "input": [{"role":"user","content":"Xin chào"},{"role":"assistant","content":"Xin chào! Tôi có thể giúp gì cho bạn hôm nay?"},{"role":"user","content":"Bạn vừa nói gì?"}] }

Khi gửi yêu cầu này, bạn sẽ nhận được phản hồi từ mô hình dựa trên các câu hỏi trước đó.

Xử Lý Hình Ảnh

Mô hình gpt-4o hỗ trợ xử lý hình ảnh bên cạnh văn bản. Để sử dụng khả năng này, bạn cần thêm trường type vào nội dung câu hỏi:

payload = { "model": "gpt-4.1", "input": [ { "role": "user", "content": [ {"type": "input_text", "text": "Có gì trong bức ảnh này?"}, { "type": "input_image", "image_url": "https://link_to_image.com" } ] } ] }

Các Thực Tiễn Tốt Nhất

• Kiểm tra token: Đảm bảo bạn không vượt quá hạn mức sử dụng token.
• Xử lý lỗi: Luôn kiểm tra phản hồi để xử lý các lỗi có thể xảy ra như mã lỗi 401 (không hợp lệ) hoặc 429 (quá nhiều yêu cầu).
• Tối ưu hóa câu hỏi: Sử dụng các câu hỏi rõ ràng và cụ thể để có được phản hồi tốt nhất từ mô hình.

Những Cạm Bẫy Thường Gặp

• Không kiểm tra kỹ các thông số trong yêu cầu API.
• Không xử lý đúng các trường hợp ngoại lệ trong mã.
• Không sử dụng các mô hình phù hợp với mục đích sử dụng.

Mẹo Tối Ưu Hiệu Suất

• Sử dụng mô hình phù hợp với nhu cầu (chẳng hạn như gpt-4o-mini cho những ai cần tiết kiệm chi phí).
• Tối ưu hóa cấu trúc dữ liệu đầu vào để giảm thiểu lượng token sử dụng.

Kết Luận

OpenAI Responses API là công cụ mạnh mẽ giúp bạn dễ dàng tích hợp khả năng tạo phản hồi vào ứng dụng của mình. Hy vọng rằng hướng dẫn này sẽ giúp bạn hiểu rõ hơn về cách sử dụng API này một cách hiệu quả. Nếu bạn có bất kỳ câu hỏi nào, đừng ngần ngại liên hệ với chúng tôi để được hỗ trợ thêm!