Câu trả lời ngắn gọn
Cụm từ image gen api openai có thể có hai nghĩa khác nhau, và việc tách biệt chúng sẽ hữu ích. Một là dịch vụ tạo ảnh của chính OpenAI, thuộc về OpenAI và bạn truy cập bằng tài khoản OpenAI. Cái kia là bất kỳ dịch vụ nào sao chép định dạng yêu cầu OpenAI để các SDK và công cụ hiện có vẫn hoạt động. Trang web này thuộc loại thứ hai, và chỉ dành cho văn bản.
Những gì bạn nhận được ở đây là một API LLM văn bản uncensored được lưu trữ. Bạn trỏ một client OpenAI vào base URL bên dưới, đặt mô hình thành uncensored và nhận các chat completions. Không có pixel nào được trả về. Không có tạo ảnh, âm thanh hoặc video, không có embeddings và không có fine-tuning, và không có cái nào trong số đó được lên kế hoạch như một phần của những gì được mô tả trên các trang này.
Cái gì tương thích và cái gì không
Từ "tương thích" thường bị thổi phồng trong marketing, nên đây là giao diện chính xác. Base URL là https://api.imagegenapi.com/v1, xác thực là Authorization: Bearer <key>, và có hai phương thức tồn tại.
| Endpoint | Có sẵn tại đây | Ghi chú |
|---|---|---|
POST /v1/chat/completions | Có | Truyền phát, gọi hàm, chế độ JSON |
GET /v1/models | Có | Liệt kê uncensored |
| Các endpoint tạo ảnh | Không | Dịch vụ chỉ văn bản |
| Embeddings, âm thanh, tinh chỉnh | Không | Không cung cấp |
Nếu mã của bạn gọi một đường dẫn ảnh trên base URL này, hãy mong đợi một lỗi, không phải một bức ảnh. Điều tương tự cũng áp dụng cho bất kỳ tính năng OpenAI nào ngoài hai phương thức ở trên. Các điều khiển lấy mẫu bạn biết đều hoạt động: temperature, top_p, stop, seed và các hình phạt được chuyển tiếp, và một phản hồi có thể sử dụng toàn bộ cửa sổ ngữ cảnh 100.000 token được chia sẻ giữa prompt và completion.
Cũng cần nói rõ về danh tính. Mô hình đằng sau uncensored là một mô hình open-weight đơn lẻ, được chạy bởi một nhà cung cấp độc lập. Đây không phải là API của OpenAI, nó không proxy các mô hình OpenAI và không liên kết với OpenAI. Trang phù hợp trên trang web này, GPT image API và uncensored text, bao gồm sự khác biệt tương tự từ góc độ tên mô hình ảnh.
Tại sao câu hỏi này lại xuất hiện
Mọi người truy cập vào các trang như thế này vì những lý do dễ hiểu. Các công cụ ảnh được điều khiển bởi prompt văn bản, prompt văn bản được viết bởi các mô hình ngôn ngữ và nhiều cổng mô hình ngôn ngữ chia sẻ một định dạng yêu cầu. Suy đoán tự nhiên là một API làm được cả hai.
Trong thực tế, hai công việc này là các hệ thống riêng biệt với các khóa riêng, giá cả riêng và quy tắc riêng. Một dịch vụ ảnh nhận một prompt và trả về một ảnh. Một dịch vụ văn bản nhận các thông điệp và trả về nhiều văn bản hơn. Mối liên kết giữa chúng là bạn, hoặc một script bạn viết, chuyển văn bản từ cái này sang cái kia. Một khi bạn thấy theo cách đó, câu hỏi hữu ích thay đổi từ "API này có tạo ảnh không" sang "API này có thể viết prompt tốt hơn cho mô hình ảnh tôi đang dùng không".
Đó là một trường hợp sử dụng thực sự, và một nơi mà một mô hình văn bản uncensored có thể quan trọng. Các trợ lý mục đích chung thường viết lại, làm mềm hoặc từ chối các yêu cầu prompt chạm đến các chủ đề truyện người lớn, bạo lực trong bối cảnh câu chuyện hoặc thẩm mỹ tối tăm. Một mô hình được tinh chỉnh để trả lời các yêu cầu người lớn hợp pháp mà không từ chối thường sẽ làm nhiệm vụ viết như yêu cầu. Giới hạn cứng vẫn tồn tại: không có nội dung tình dục liên quan đến người chưa thành niên, dưới bất kỳ hình thức nào.
Sử dụng API văn bản để viết prompt ảnh
Dưới đây là một ví dụ nhỏ, hoạt động. Nó yêu cầu mô hình tạo một prompt chi tiết, sau đó bạn dán vào bất kỳ công cụ tạo ảnh nào bạn sử dụng. Mã nguồn sử dụng SDK Python chính thức của OpenAI với base URL này.
from openai import OpenAI
client = OpenAI(base_url="https://api.imagegenapi.com/v1", api_key="YOUR_KEY")
reply = client.chat.completions.create(
model="uncensored",
temperature=0.8,
messages=[
{"role": "system", "content": "You write prompts for text-to-image models. Reply with one paragraph: subject, composition, lighting, palette, lens or style. No preamble."},
{"role": "user", "content": "A ruined lighthouse at dusk for a dark fantasy book cover."},
],
)
print(reply.choices[0].message.content)Gọi tương tự từ dòng lệnh:
curl https://api.imagegenapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Write a one-paragraph image prompt: a ruined lighthouse at dusk, dark fantasy cover art."}]}'Làm cho đầu ra có thể sử dụng được
Các bộ tạo ảnh khác nhau về những gì chúng chấp nhận, vì vậy hãy định dạng kết quả bằng thông điệp hệ thống (system message) của bạn. Yêu cầu một cấu trúc cố định, giới hạn từ và một danh sách các thứ cần tránh. Nếu bạn cần prompt bên trong một pipeline, hãy yêu cầu JSON với response_format đặt thành loại json_object và yêu cầu các khóa như prompt và negative. Sau đó phân tích cú pháp và chuyển các trường này đến client ảnh của bạn. Đặt một seed và một temperature thấp cho đầu ra có thể lặp lại hơn khi bạn tinh chỉnh cách diễn đạt.
Quy trình hàng loạt với số liệu thực tế
Giả sử bạn tạo prompt cho 1.000 cảnh. Mỗi yêu cầu gửi khoảng 300 token (chỉ dẫn cộng với ghi chú cảnh ngắn) và nhận một prompt khoảng 200 token. Giá là $0,15 cho mỗi 1M token đầu vào và $0,50 cho mỗi 1M token đầu ra.
- Một yêu cầu, đầu vào: 300 / 1.000.000 x $0,15 = $0,000045.
- Một yêu cầu, đầu ra: 200 / 1.000.000 x $0,50 = $0,0001.
- Tổng cộng một yêu cầu: $0,000145.
- 1.000 yêu cầu: 1.000 x $0,000145 = $0,145.
Vì vậy, một nghìn prompt tốn khoảng 14,5 xu và bước văn bản thường là một phần nhỏ của hóa đơn so với chính việc tạo ảnh, bạn nên kiểm tra giá với nhà cung cấp đó. Một khóa đầy đủ cho phép 8 yêu cầu đồng thời và 300 yêu cầu mỗi phút, vì vậy 1.000 yêu cầu vừa trong vài phút với một nhóm worker nhỏ. Xử lý HTTP 429 bằng cách chờ; tiêu đề Retry-After: 5 cho bạn biết thời gian chờ khi quá tải tạm thời.
Bạn có thể thử tất cả điều này mà không cần trả tiền. Sau khi đăng ký, trang khóa API có tín dụng dùng thử $0,50 một cú nhấp chuột, có hiệu lực trong 7 ngày. Dài hạn, mức nạp tiền từ $20 đến $500 và được thanh toán bằng crypto (USDT trên TRC20 hoặc USDC trên Base); xem bảng giá cho các cấp bonus.
Những lỗi cần tránh
Một vài lỗi xuất hiện lặp đi lặp lại khi ai đó cố gắng sử dụng một endpoint kiểu OpenAI cho công việc ảnh.
- Gọi một đường dẫn ảnh và mong đợi một bức ảnh. Chỉ có hai phương thức được tài liệu hóa tồn tại tại đây. Kiểm tra nội dung phản hồi lỗi (error body) thay vì thử lại, vì các lần thử lại sẽ không thay đổi kết quả.
- Yêu cầu mô hình văn bản "vẽ" một thứ gì đó. Nó có thể trả lời bằng nghệ thuật ASCII, một mô tả hoặc một lời xin lỗi. Nếu bạn muốn một bức ảnh, hãy gửi prompt nó viết đến một bộ tạo ảnh thực sự.
- Bỏ qua danh sách mô hình. Một lệnh gọi
GET /v1/modelsnhanh chóng xác nhận khóa hoạt động và rằng mô hình duy nhất làuncensored. Nó không tốn gì. - Bỏ qua các phản hồi 429. Một khóa dùng thử cho phép 2 yêu cầu đồng thời, vì vậy một vòng lặp với mười worker sẽ thất bại nhanh. Giới hạn số lượng worker của bạn hoặc thêm một khoảng chờ ngắn.
- Gửi body rất lớn. Giới hạn là 8 MB mỗi yêu cầu. Các lệnh gọi viết prompt rất nhỏ, vì vậy điều này hiếm khi quan trọng, nhưng các tài liệu dán vào có thể đạt đến giới hạn đó.
Không có cái nào trong số này khó sửa, và cách chữa nhanh nhất là một script kiểm tra mười dòng chạy trước khi bạn kết nối bất cứ thứ gì vào một công cụ lớn hơn.
Khi nào dịch vụ khác phù hợp hơn
Hãy thực tế về sự lựa chọn. Nếu bạn cần chính bức ảnh, bạn cần một nhà cung cấp ảnh và OpenAI là một trong nhiều nhà cung cấp; hãy xem tài liệu và giá cả hiện tại của nó để biết chi tiết về những gì nó cung cấp. Nếu mục tiêu duy nhất của bạn là một prompt sạch theo phong cách chính thống, một trợ lý tiêu chuẩn có thể đủ và bạn sẽ không cần dịch vụ này.
API này phù hợp hơn khi bước xử lý văn bản là nút thắt: trợ lý bạn dùng từ chối hoặc làm giảm chất lượng prompt của bạn, bạn cần một khối lượng lớn prompt với giá mỗi token dự đoán được, hoặc bạn muốn một endpoint tương thích OpenAI cho truyện, nhập vai và công cụ đồng hành dùng hợp pháp cho người trưởng thành mà không cần viết lại mã client. Để biết chi tiết tham số, tài liệu có định dạng yêu cầu và mã lỗi.
Một ghi chú thực tế hơn nữa: các prompt gửi đến API này không được sử dụng để huấn luyện. Tuy nhiên, hãy coi bất kỳ dịch vụ lưu trữ nào là nằm ngoài máy của bạn và tránh gửi các bí mật mà bạn không muốn dán vào biểu mẫu web.
