# GPT 5.5 API Tài liệu tham khảo API đầy đủ cho các mô hình mô hình ngôn ngữ lớn GPT 5.5 do OpenAI cung cấp. ## Biến thể mô hình API này hỗ trợ bốn biến thể mô hình: | Mô hình | ID | Mô tả | |-------|----|-------------| | **GPT 5.5 Text to Text** | `gpt-5.5-text-to-text` | mô hình ngôn ngữ lớn văn bản tổng quát và suy luận | | **GPT 5.5 Image to Text** | `gpt-5.5-image-to-text` | Hiểu hình ảnh bằng hướng dẫn văn bản | | **GPT 5.5 Web Search** | `gpt-5.5-web-search` | mô hình ngôn ngữ lớn văn bản với khả năng tìm kiếm web | | **GPT 5.5 File Analysis** | `gpt-5.5-file-analysis` | Phân tích tệp bằng hướng dẫn văn bản | ## So sánh nhanh | Tính năng | Text to Text | Image to Text | Web Search | File Analysis | |---------|--------------|---------------|------------|---------------| | Đầu vào văn bản | Bắt buộc ✅ | Tùy chọn | Bắt buộc ✅ | Tùy chọn | | Đầu vào hình ảnh | Không hỗ trợ ❌ | Tùy chọn | Tùy chọn | Tùy chọn | | Đầu vào tệp | Không hỗ trợ ❌ | Không hỗ trợ ❌ | Tùy chọn | Tùy chọn | | Phản hồi streaming | SSE | SSE | SSE | SSE | | `max_tokens` | Tùy chọn | Tùy chọn | Tùy chọn | Tùy chọn | ## GPT 5.5 Text to Text ### Endpoint ```http POST /api/v1/chat/completions ``` ### Tham số yêu cầu #### Bắt buộc | Tham số | Kiểu | Mô tả | |-----------|------|-------------| | `model` | string | Phải là `"gpt-5.5-text-to-text"` | | `messages` | array | Các tin nhắn theo thứ tự. Xem mô hình ngôn ngữ lớn API để biết cấu trúc tin nhắn. | | `stream` | boolean | `true` cho SSE, `false` cho một phản hồi JSON duy nhất. | #### Hỗ trợ tin nhắn | Trường | Văn bản | Tệp | Hình ảnh | |-------|------|------|-------| | `messages` | Bắt buộc ✅ | Không hỗ trợ ❌ | Không hỗ trợ ❌ | #### Tùy chọn | Tham số | Kiểu | Phạm vi | Mô tả | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 1` | Số token đầu ra tối đa. | ### Ví dụ yêu cầu ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'gpt-5.5-text-to-text', messages: [ { role: 'user', content: 'Write a short launch announcement for a new AI feature.' } ], stream: true, max_tokens: 2048 }) }); ``` ## GPT 5.5 Image to Text ### Endpoint ```http POST /api/v1/chat/completions ``` ### Tham số yêu cầu #### Bắt buộc | Tham số | Kiểu | Mô tả | |-----------|------|-------------| | `model` | string | Phải là `"gpt-5.5-image-to-text"` | | `messages` | array | Các tin nhắn theo thứ tự. Xem mô hình ngôn ngữ lớn API và mô hình ngôn ngữ lớn Attachments. | | `stream` | boolean | `true` cho SSE, `false` cho một phản hồi JSON duy nhất. | #### Hỗ trợ tin nhắn | Trường | Văn bản | Tệp | Hình ảnh | |-------|------|------|-------| | `messages` | Tùy chọn | Không hỗ trợ ❌ | Tùy chọn | #### Tùy chọn | Tham số | Kiểu | Phạm vi | Mô tả | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 1` | Số token đầu ra tối đa. | ### Ví dụ yêu cầu ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'gpt-5.5-image-to-text', messages: [ { role: 'user', content: [ { type: 'text', text: 'Describe the image and extract any visible text.' }, { type: 'image_url', image_url: { url: 'https://example.com/sample-image.jpg' } } ] } ], stream: true, max_tokens: 2048 }) }); ``` ## GPT 5.5 Web Search ### Endpoint ```http POST /api/v1/chat/completions ``` ### Tham số yêu cầu #### Bắt buộc | Tham số | Kiểu | Mô tả | |-----------|------|-------------| | `model` | string | Phải là `"gpt-5.5-web-search"` | | `messages` | array | Các tin nhắn theo thứ tự. Xem mô hình ngôn ngữ lớn API và mô hình ngôn ngữ lớn Attachments. | | `stream` | boolean | `true` cho SSE, `false` cho một phản hồi JSON duy nhất. | #### Hỗ trợ tin nhắn | Trường | Văn bản | Tệp | Hình ảnh | |-------|------|------|-------| | `messages` | Bắt buộc ✅ | Tùy chọn | Tùy chọn | #### Tùy chọn | Tham số | Kiểu | Phạm vi | Mô tả | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 1` | Số token đầu ra tối đa. | ### Ví dụ yêu cầu ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'gpt-5.5-web-search', messages: [ { role: 'user', content: 'Find recent product launch trends in AI developer tools.' } ], stream: true, max_tokens: 2048 }) }); ``` ## GPT 5.5 File Analysis ### Endpoint ```http POST /api/v1/chat/completions ``` ### Tham số yêu cầu #### Bắt buộc | Tham số | Kiểu | Mô tả | |-----------|------|-------------| | `model` | string | Phải là `"gpt-5.5-file-analysis"` | | `messages` | array | Các tin nhắn theo thứ tự. Xem mô hình ngôn ngữ lớn API và mô hình ngôn ngữ lớn Attachments. | | `stream` | boolean | `true` cho SSE, `false` cho một phản hồi JSON duy nhất. | #### Hỗ trợ tin nhắn | Trường | Văn bản | Tệp | Hình ảnh | |-------|------|------|-------| | `messages` | Tùy chọn | Tùy chọn | Tùy chọn | #### Tùy chọn | Tham số | Kiểu | Phạm vi | Mô tả | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 1` | Số token đầu ra tối đa. | ### Ví dụ yêu cầu ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'gpt-5.5-file-analysis', messages: [ { role: 'user', content: [ { type: 'text', text: 'Summarize this document and list the key action items.' }, { type: 'file', file: { filename: 'demo.pdf', file_data: 'https://example.com/demo.pdf' } } ] } ], stream: true, max_tokens: 2048 }) }); ``` ## Định dạng phản hồi Các mô hình LLM GPT 5.5 trả về phản hồi completion tương thích OpenAI. Với `stream: true`, phản hồi là Server-Sent Events; với `stream: false`, phản hồi là một đối tượng JSON duy nhất. ### Phản hồi thành công ```text data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"gpt-5.5-image-to-text","choices":[{"index":0,"delta":{"role":"assistant"},"finish_reason":null}]} data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"gpt-5.5-image-to-text","choices":[{"index":0,"delta":{"content":"The image shows"},"finish_reason":null}]} data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"gpt-5.5-image-to-text","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]} data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"gpt-5.5-image-to-text","choices":[],"usage":{"prompt_tokens":12,"completion_tokens":8,"total_tokens":20}} data: [DONE] ``` ### Phản hồi lỗi ```text event: error data: {"error":{"message":"API requests too frequent, exceeding rate limit","type":"rate_limit_error","code":"1302","param":null}} ``` ## Thực hành tốt nhất 1. **Giữ tin nhắn có cấu trúc:** Dùng `messages[]` cho lịch sử hội thoại thay vì gộp toàn bộ ngữ cảnh vào một prompt. 2. **Đính kèm tệp và hình ảnh vào tin nhắn:** Đặt các phần `image_url` và `file` trong tin nhắn giới thiệu chúng. 3. **Dùng phân tích SSE:** Dùng `choices[0].delta.content` để hiển thị tăng dần và `data: [DONE]` cho nội dung cuối cùng. 4. **Chỉ gửi đầu vào được hỗ trợ:** Khớp các phần văn bản, hình ảnh và tệp với biến thể mô hình đã chọn. 5. **Lưu trạng thái yêu cầu cục bộ:** chunk bao gồm completion `id`, nhưng client vẫn nên định tuyến chunk qua trạng thái yêu cầu đang hoạt động.