Cấu hình OpenAI Images API
Tạo hình ảnh không phải là giao diện trò chuyện thông thường. Ngay cả khi một nhà cung cấp AI hỗ trợ mô hình văn bản, điều đó không nhất thiết có nghĩa là họ hỗ trợ giao diện hình ảnh của OpenAI. Hãy kiểm tra với nhà cung cấp xem họ có đề cập rõ ràng đến 'Images API', 'tạo hình ảnh' hoặc mô hình tương ứng hay không trước khi cấu hình.
Thông tin chính thức Tải xuống và tài liệu hướng dẫn tùy thuộc vào trang web chính thức.
Trước tiên hãy xác nhận xem nhà cung cấp có hỗ trợ giao diện hình ảnh hay không
| Cần kiểm tra gì | Cách xem | Lý do |
|---|---|---|
| Loại giao diện | Trang quản trị hoặc tài liệu có đề cập rõ ràng đến Images API, tạo hình ảnh, chỉnh sửa hình ảnh hay không | Chỉ ghi giao diện trò chuyện tương thích với OpenAI không có nghĩa là giao diện hình ảnh cũng khả dụng |
| Quyền của mô hình | Danh sách mô hình có bao gồm các mô hình hình ảnh không, và tài khoản hoặc Key có quyền hay không | Các mô hình hình ảnh thường được tính phí riêng và kích hoạt riêng biệt với các mô hình văn bản |
| Đường dẫn yêu cầu | Nhà cung cấp có đưa ra ví dụ cho giao diện hình ảnh hay không | Một số nhà cung cấp chỉ chuyển tiếp giao diện trò chuyện; yêu cầu trực tiếp đến đường dẫn hình ảnh sẽ trả về lỗi 404 |
| Giá cả | Hình ảnh được tính phí theo từng tấm, kích thước hoặc chất lượng | Hãy thử nghiệm với số lượng nhỏ trước khi tạo hàng loạt để tránh chi phí tăng cao đột ngột |
Khác biệt so với giao diện trò chuyện
| Loại | Giao diện phổ biến | Chuẩn bị cần thiết |
|---|---|---|
| Trò chuyện văn bản | /v1/chat/completions hoặc Responses | Key, Base URL, tên mô hình, nội dung tin nhắn |
| Tạo hình ảnh | /v1/images/generations | Key, mô hình hình ảnh, prompt, kích thước, định dạng đầu ra |
| Chỉnh sửa hình ảnh | Giao diện chỉnh sửa hình ảnh | Ngoài prompt, bạn cũng cần tải lên hình ảnh gốc hoặc mask |
Cách điền các trường
| Mục cấu hình | Cách điền |
|---|---|
| Endpoint | https://api.openai.com/v1/images/generations |
| Model | Ví dụ chính thức có sẵn: <code>gpt-image-2</code>; đối với dịch vụ của nhà cung cấp, hãy điền theo danh sách của nhà cung cấp |
| Prompt | Bạn muốn tạo hình ảnh gì |
| Size | Kích thước hình ảnh |
| Format | URL hoặc base64 |
Nếu sử dụng nhà cung cấp, hãy thay thế phần tên miền chính thức bằng địa chỉ API hình ảnh do nhà cung cấp cung cấp; nếu nhà cung cấp không nêu rõ việc hỗ trợ giao diện hình ảnh, đừng mặc định là nó khả dụng. Việc Base URL có bao gồm /v1 hay không vẫn phải tuân theo ví dụ trong trang quản trị, đừng tự ý đoán.
Ví dụ yêu cầu
Ví dụ tạo hình ảnh OpenAI
curl https://api.openai.com/v1/images/generations \ -H "Authorization: Bearer YOUR_OPENAI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-image-2", "prompt": "A clean product photo of a white ceramic mug on a solid-color background", "size": "1024x1024" }'Chi phí của giao diện hình ảnh thường khác với giao diện văn bản. Hãy kiểm tra giá trước khi tạo hàng loạt.
| Lỗi | Nguyên nhân phổ biến | Giải pháp |
|---|---|---|
| 404 / endpoint not found | Nhà cung cấp không có giao diện proxy hình ảnh, hoặc đường dẫn thừa/thiếu dấu gạch chéo /v1 | Vào trang quản trị để tìm ví dụ giao diện hình ảnh chuyên dụng; không sử dụng trực tiếp giao diện trò chuyện |
| model not found | Tên mô hình hình ảnh không có trong danh sách của nhà cung cấp hiện tại | Sao chép đúng Model ID/tên mô hình gốc của mô hình hình ảnh, không phải mô hình văn bản |
| unsupported content type | Giao diện chỉnh sửa hình ảnh yêu cầu tải lên tệp tin; bạn không thể chỉ gửi JSON | Trước tiên hãy xác nhận xem bạn đang gọi giao diện tạo hình ảnh hay giao diện chỉnh sửa |