Đây có phải là API ảnh Gemini của Google không?
Không. Nếu bạn đến đây khi đang tìm kiếm endpoint tạo ảnh Gemini, điều đầu tiên cần làm rõ là ai vận hành cái gì. Gemini là họ mô hình của Google, và Google cung cấp tạo ảnh thông qua các sản phẩm dành cho nhà phát triển của riêng họ. Bất kể những sản phẩm đó có thể làm được gì, bạn đều truy cập chúng thông qua Google, với tài khoản, khóa và điều khoản của Google.
Trang web này là một dịch vụ khác. Đây là API văn bản được lưu trữ, trong đó một mô hình trọng số mở duy nhất, do nhà cung cấp độc lập vận hành, được tinh chỉnh để trả lời mà không từ chối nội dung cho mục đích người lớn hợp pháp. Nó không phải là nhà bán lại Gemini, không chuyển hướng yêu cầu đến Google và không được Google hay bất kỳ nhà cung cấp mô hình nào khác bảo trợ. Tên miền đề cập đến tạo ảnh vì nhiều khách truy cập đến đây tìm kiếm sự trợ giúp về prompt, không phải vì ảnh được tạo ra tại đây.
Những gì bạn thực sự nhận được
Phạm vi được giới hạn có chủ đích, giúp bạn dễ dàng đánh giá trong vài phút.
- Giao thức: Tương thích OpenAI. Bất kỳ SDK hoặc máy khách OpenAI nào cũng hoạt động sau khi bạn thay đổi hai thứ: base URL và khóa.
- Base URL:
https://api.imagegenapi.com/v1 - ID mô hình:
uncensored - Phương thức:
POST /v1/chat/completionsvàGET /v1/models - Tính năng: truyền phát qua SSE, gọi hàm, chế độ JSON và truyền tham số lấy mẫu (
temperature,top_p,stop,seed, penalty). - Cửa sổ ngữ cảnh: 100.000 token, prompt cộng completion.
Không bao gồm: tạo ảnh, đầu vào ảnh, âm thanh, video, embeddings và fine-tuning. Nếu một tính năng không có trong danh sách trên, hãy giả định là nó không có. Trang tài liệu có định dạng yêu cầu và các mã lỗi.
Bên thứ ba so với chính thức: cách phân biệt
Sự nhầm lẫn này rất phổ biến trên toàn thị trường, vì vậy một danh sách kiểm tra nhanh sẽ hữu ích bất cứ khi nào bạn gặp API có tên nghe giống của một nhà cung cấp lớn.
- Xem tên miền và điều khoản. API chính thức nằm dưới tên miền và điều khoản của chính nhà cung cấp. Dịch vụ bên thứ ba sẽ nói rõ điều đó, hoặc ít nhất là nêu rõ nhà vận hành của mình.
- Kiểm tra danh sách mô hình. Tại đây,
GET /v1/modelstrả về một mô hình duy nhất,uncensored. Bộ định tuyến sẽ liệt kê nhiều tên mô hình của các nhà cung cấp khác nhau. - Đọc những gì được hứa hẹn. Các tuyên bố như "hàng chính hiệu nhưng rẻ hơn" đáng bị nghi ngờ. Dịch vụ đáng tin cậy sẽ cho bạn biết những tính năng nào bị thiếu.
- Thử nghiệm. Gửi một vài yêu cầu với tín dụng dùng thử trước khi bạn chuyển bất kỳ tác vụ nào.
Trên trang web này, câu trả lời rất rõ ràng: nhà cung cấp độc lập, một mô hình trọng số mở, chỉ xử lý văn bản. Hãy coi bất kỳ cách hiểu nào khác là sai lầm. Bạn có thể xác minh danh tính của mô hình thông qua hành vi, nhưng bạn không nên mong đợi nó tuyên bố là sản phẩm của một nhà cung cấp cụ thể.
Cách kết hợp hợp lý giữa công cụ văn bản và ảnh
Các mô hình ảnh được điều khiển bởi prompt, và viết prompt tốt chủ yếu là một nhiệm vụ xử lý văn bản. Quy trình phổ biến do đó gồm hai bước: yêu cầu mô hình ngôn ngữ tạo ra một prompt chi tiết, sau đó dán hoặc chuyển hướng prompt đó vào dịch vụ ảnh bạn đã chọn, của Google hoặc bất kỳ ai khác. Mô hình văn bản ở đây xử lý bước một.
from openai import OpenAI
client = OpenAI(base_url="https://api.imagegenapi.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
temperature=0.7,
messages=[
{"role": "system", "content": "Turn a short idea into a detailed prompt for a text-to-image model. Include subject, setting, lighting, color palette and mood. One paragraph."},
{"role": "user", "content": "A smuggler's market inside a hollowed-out whale skeleton, neon lanterns."},
],
)
print(resp.choices[0].message.content)
Đối với pipeline, hãy yêu cầu JSON để giai đoạn tiếp theo có thể đọc các trường. Dưới đây là mã trong Node với gói openai chính thức:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.imagegenapi.com/v1",
apiKey: process.env.API_KEY,
});
const res = await client.chat.completions.create({
model: "uncensored",
response_format: { type: "json_object" },
messages: [
{ role: "user", content: "Return JSON with keys prompt and style for: a whale-skeleton night market." },
],
});
const out = JSON.parse(res.choices[0].message.content);
console.log(out.prompt);
Một vài lưu ý về các đoạn mã đó. Thông báo hệ thống đảm nhận phần công việc nặng, vì vậy hãy dành thời gian cho phần đó. Khóa API phải nằm trong biến môi trường, không bao giờ nằm trong hệ thống kiểm soát nguồn. Và nếu lệnh gọi thất bại với mã 429, hãy đợi và thử lại thay vì lặp ở tốc độ tối đa, vì vòng lặp chặt chẽ chỉ làm cạn kiệt nhanh chóng hạn mức mỗi phút của bạn. Mã tương tự chạy không thay đổi trên các máy chủ tương thích OpenAI khác, đó là điểm mạnh của giao thức chia sẻ: bạn có thể chuyển nhà cung cấp bằng cách thay đổi base URL và tên mô hình.
Hãy nhớ rằng trọng tâm vào mục đích sử dụng hợp pháp dành cho người lớn áp dụng cho nội dung bạn yêu cầu. Truyện giả tưởng, nhập vai và ứng dụng bạn đời là các trường hợp sử dụng điển hình, và nội dung tình dục liên quan đến người chưa thành niên bị chặn mà không có ngoại lệ.
Viết prompt phù hợp với mô hình ảnh
Phần lớn giá trị trong bước văn bản đến từ các hướng dẫn bạn cung cấp, không chỉ từ mô hình. Một vài thói quen sẽ khiến đầu ra dễ sử dụng hơn nhiều.
Cung cấp cho mô hình một công thức cố định
Nói cho nó thứ tự các phần bạn muốn: chủ thể trước, sau đó là bối cảnh, rồi ánh sáng, bảng màu, rồi phong cách. Các mô hình ảnh có xu hướng chú trọng hơn vào các từ đầu tiên, vì vậy thứ tự ổn định giúp kết quả có thể so sánh được giữa các lần chạy. Thêm giới hạn số từ, vì prompt quá dài thường làm loãng chủ thể chính thay vì cải thiện nó.
Nói rõ những gì cần loại trừ
Một số công cụ ảnh yêu cầu một prompt phủ định riêng, số khác bỏ qua nó. Hãy yêu cầu mô hình văn bản trả về hai phần dưới dạng các trường JSON riêng biệt, sau đó bỏ trường thứ hai nếu công cụ của bạn không cần. Cách này đơn giản hơn việc chỉnh sửa một đoạn văn dài bằng tay.
Lặp lại trong cùng một cuộc trò chuyện
Giữ các thông báo trước đó trong danh sách messages và yêu cầu thay đổi: ánh sáng ấm hơn, góc chụp rộng hơn, ít nhân vật hơn. Cửa sổ ngữ cảnh là 100.000 token, vì vậy ngay cả một phiên chỉnh sửa dài cũng vừa vặn. Giảm temperature khi bạn muốn chỉnh sửa nhỏ và tăng nó khi bạn muốn ý tưởng mới.
Kiểm thử một vài seed
Nếu bạn truyền cùng seed với cùng các thông báo và cài đặt, đầu ra sẽ giữ gần giống nhau từ lần chạy này sang lần khác. Chỉ thay đổi một thứ tại một thời điểm, chẳng hạn như thông báo hệ thống, và bạn có thể biết thay đổi nào đã cải thiện kết quả. Kỷ luật đó tiết kiệm nhiều tiền hơn bất kỳ gói giá nào, vì ít lần tạo ảnh lãng phí chính là cách tiết kiệm chi phí thực sự.
Chi phí cho bước văn bản
Giá là $0,15 cho mỗi 1 triệu token đầu vào và $0,50 cho mỗi 1 triệu token đầu ra, từ tín dụng trả trước, không có gói đăng ký. Các yêu cầu bị từ chối hoặc thất bại không bị tính phí. Hãy thực hiện một lô gồm 1.000 lệnh gọi viết prompt, mỗi lệnh gọi có 400 token đầu vào và 250 token đầu ra.
- Đầu vào mỗi lệnh gọi: 400 / 1.000.000 x $0,15 = $0,00006.
- Đầu ra mỗi lệnh gọi: 250 / 1.000.000 x $0,50 = $0,000125.
- Mỗi lệnh gọi: $0,000185.
- Mỗi 1.000 lệnh gọi: $0,185.
Đó là 18,5 cent cho lô đó. Hãy so sánh nó với giá của nhà cung cấp ảnh của bạn cho mỗi bức ảnh, điều bạn nên tra cứu trên trang giá của họ, và bạn sẽ thường thấy rằng bước viết prompt là bước rẻ hơn.
Bắt đầu với tín dụng
Người dùng mới có thể nhận $0,50 tín dụng dùng thử bằng một cú nhấp chuột trên trang khóa API sau khi đăng ký bằng Google hoặc bằng email và mật khẩu. Nó không cần thanh toán và kéo dài 7 ngày. Sau đó, bạn có thể nạp tiền với bất kỳ số nguyên nào từ $20 đến $500 bằng tiền mã hóa (USDT trên TRC20 hoặc USDC trên Base). Bonus là +5% từ $50, +10% từ $100 và +15% từ $200, và tín dụng không bao giờ hết hạn. Xem bảng giá để có cái nhìn đầy đủ.
Giới hạn để bạn lên kế hoạch
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. Một khóa dùng thử cho phép 2 yêu cầu đồng thời và 60 yêu cầu mỗi phút. Vượt quá giới hạn đầu tiên sẽ trả về HTTP 429 với mã rate_limited, vượt quá giới hạn thứ hai sẽ trả về 429 với mã concurrency, và quá tải tạm thời sẽ trả về 429 với tiêu đề Retry-After: 5. Một yêu cầu truyền phát giữ slot của nó cho đến khi luồng kết thúc, vì vậy hãy đóng các luồng bạn không còn cần nữa.
Các tiêu đề phản hồi bao gồm X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests và X-RateLimit-Limit-Concurrency. Hãy ghi lại ID yêu cầu với mọi lỗi, vì đó là cách nhanh nhất để nhận trợ giúp từ hỗ trợ. Kích thước body tối đa là 8 MB.
Nếu bạn cần gọi API hình ảnh Gemini gốc, hãy truy cập Google và đọc tài liệu hiện tại của họ. Nếu bạn cần một mô hình văn bản không kiểm duyệt hỗ trợ giao thức OpenAI để viết prompt, truyện hoặc hội thoại nhân vật cho mục đích người trưởng thành hợp pháp, đây là giải pháp được xây dựng cho việc đó.
