VI ▾

API văn bản không kiểm duyệt cho quy trình tạo ảnh của bạn

Lấy khóa API

API tạo ảnh Gemini: Dịch vụ này là gì

Đây không phải là API tạo ảnh Gemini cung cấp, và cũng không phải dịch vụ của Google dưới bất kỳ hình thức nào. Đây là API LLM văn bản tương thích OpenAI độc lập với một mô hình duy nhất.

Cập nhật

Điểm chính

  • Dịch vụ này thuộc bên thứ ba và không liên kết với Google hay các mô hình Gemini của Google.
  • Nó chỉ trả về văn bản: không tạo ảnh, không nhận ảnh đầu vào, không có embedding.
  • Bạn dùng nó để soạn và tinh chỉnh prompt rồi gửi đến bất kỳ mô hình ảnh nào bạn thích.
  • Các lệnh gọi tuân theo định dạng chat của OpenAI, với model ID là uncensored.
Hai hòn đảo được nối bằng một cây cầu, một bên có terminal văn bản và một bên có khung hình trống, hiển thị các công cụ văn bản và ảnh

Đâ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/completions và 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.

  1. 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.
  2. Kiểm tra danh sách mô hình. Tại đây, GET /v1/models trả 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.
  3. Đọ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.
  4. 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 đó.

Hỏi đáp

Dịch vụ này có sử dụng mô hình Gemini không?

Không. Dịch vụ chạy một mô hình trọng số mở duy nhất từ nhà cung cấp độc lập và không chuyển hướng đến Google hoặc bất kỳ nhà cung cấp nào khác.

Tôi có thể tạo hình ảnh với dịch vụ này không?

Không. Dịch vụ chỉ hỗ trợ văn bản. Bạn có thể sử dụng nó để viết prompt cho trình tạo hình ảnh, nhưng hình ảnh sẽ đến từ dịch vụ hình ảnh mà bạn chọn.

Tôi nên dùng model ID nào?

Sử dụng uncensored với base URL https://api.imagegenapi.com/v1. Bạn có thể xác nhận bằng một yêu cầu GET đến /v1/models.

Có cách nào dùng thử miễn phí không?

Có. Sau khi đăng ký, bạn có thể nhận $0,50 tín dụng dùng thử chỉ với một cú nhấp chuột trên trang khóa API. Tín dụng này có hiệu lực trong 7 ngày và không yêu cầu thanh toán.

Khóa của bạn chỉ cách một biểu mẫu

Tạo tài khoản, sao chép khóa, thay đổi base URL. Đó là toàn bộ thiết lập.

Lấy khóa API