簡短答案
片語 image gen api openai 可能指兩種不同的事物,釐清它們很有幫助。其一是 OpenAI 自己的圖像生成服務,屬於 OpenAI,你需要使用 OpenAI 帳戶存取。其二是任何複製 OpenAI 請求格式的服務,讓現有的 SDK 和工具繼續運作。本網站屬於第二種,且僅限文字。
你在此獲得的是託管的無審查文字 LLM API。將 OpenAI 客戶端指向下方的 base URL,將模型設為 uncensored,即可取得聊天完成內容。不會回傳像素。沒有圖像、音訊或影片生成,沒有嵌入,也沒有微調,且這些都不是這些頁面所述計畫的一部分。
相容與不相容之處
行銷常誇大「相容」一詞,這裡是確切的支援範圍。base URL 為 https://api.imagegenapi.com/v1,驗證為 Authorization: Bearer <key>,且存在兩種方法。
| 端點 | 此處可用 | 備註 |
|---|---|---|
POST /v1/chat/completions | 是 | 串流輸出、函式呼叫、JSON 模式 |
GET /v1/models | 是 | 列出 uncensored |
| 圖像生成端點 | 否 | 僅限文字服務 |
| 嵌入、音訊、微調 | 否 | 不提供 |
如果你的程式碼在此 base URL 呼叫圖片路徑,會收到錯誤而非圖片。上述兩種方法以外的任何 OpenAI 功能亦然。你熟悉的採樣控制參數確實有效:temperature、top_p、stop、seed,且懲罰機制會原樣傳遞,回覆可以使用提示詞與補全內容共享的完整 100,000 token 上下文視窗。
清楚說明身分也很重要。uncensored背後的模型是單一開放權重模型,由獨立供應商運行。這不是 OpenAI 的 API,不代理 OpenAI 模型,也與 OpenAI 無隸屬關係。本網站的對應頁面 GPT 圖像 API 與無審查文字從圖像模型名稱的角度涵蓋了此區別。
為何會提出此問題
人們會因為合理的原因來到此類頁面。圖像工具由文字提示詞驅動,文字提示詞由語言模型撰寫,許多語言模型閘道器共用一種請求格式。自然的猜測是單一 API 能同時處理兩件事。
實際上,這兩項工作是具有不同金鑰、不同定價和不同規則的獨立系統。圖像服務接收提示詞並回傳圖像。文字服務接收訊息並回傳更多文字。它們之間的連結是你,或你撰寫的腳本,將文字從一方帶到另一方。一旦你這樣看待,有用的問題就會從「這個 API 能產生圖像嗎」轉變為「這個 API 能否為我已經使用的圖像模型撰寫更好的提示詞」。
這是一個真實的使用案例,也是無審查文字模型可以發揮作用的地方。通用助手經常會改寫、柔化或拒絕涉及成熟小說主題、故事設定中的暴力或黑暗美學的提示詞請求。針對合法成人請求進行調整且不會拒絕的模型,通常會按要求完成寫作任務。硬性限制仍然存在:任何情況下都不涉及未成年人的性內容。
使用文字 API 撰寫圖像提示詞
這裡有一個小型且可運作的範例。它要求模型提供詳細的提示詞,然後將其貼入你使用的任何圖片生成器。程式碼使用官方 OpenAI Python SDK 針對此 base URL 進行操作。
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)
從命令列的相同呼叫:
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."}]}'
使輸出可用
圖像生成器接受的內容各不相同,因此請使用系統訊息來塑造結果。要求固定結構、字數限制以及要避免的項目列表。如果你需要在管線中使用提示詞,請設定 response_format 為類型 json_object,並要求包含 prompt 和 negative 等鍵。然後解析它並將欄位傳遞給你的圖像客戶端。設定 seed 和低 temperature 可在你迭代用詞時提供更可重複的輸出。
含真實數字的批次工作流程
假設你為 1,000 個場景生成提示詞。每個請求發送約 300 token(指令加上短場景說明),並接收約 200 token 的提示詞。定價為每 1M 輸入 token $0.15,每 1M 輸出 token $0.50。
- 單一請求,輸入:300 / 1,000,000 x $0.15 = $0.000045。
- 單一請求,輸出:200 / 1,000,000 x $0.50 = $0.0001。
- 單一請求總計:$0.000145。
- 1,000 個請求:1,000 x $0.000145 = $0.145。
因此,一千個提示詞的成本約為 14.5 美分,與圖像生成本身的費用相比,文字步驟通常只佔小部分,其價格應向該供應商查詢。完整金鑰允許 8 個並行請求和每分鐘 300 個請求,因此 1,000 個請求可在少量工作池的情況下於幾分鐘內完成。處理 HTTP 429 時請等待;Retry-After: 5 標頭會告訴你在暫時超載時需要等待的時間。
你可以免費嘗試所有這些功能。註冊後,API 金鑰頁面有一個一鍵式 $0.50 試用額度,有效期為 7 天。長期來看,儲值金額從 $20 到 $500 不等,並透過加密貨幣支付(TRC20 上的 USDT 或 Base 上的 USDC);請參閱 定價 查看獎勵等級。
應避免的錯誤
當有人嘗試使用 OpenAI 格式的端點進行圖像工作時,會反覆出現一些錯誤。
- 呼叫圖像路徑並期望獲得圖片。 此處僅存在兩種記錄的方法。請檢查錯誤訊息而非重試,因為重試不會改變結果。
- 要求文字模型「繪製」某些內容。 它可能會以 ASCII 藝術、描述或道歉來回答。如果你想要圖片,請將它撰寫的提示詞發送給實際的圖像生成器。
- 跳過模型列表。 快速的
GET /v1/models呼叫可確認金鑰有效且唯一模型為uncensored。這不收費。 - 忽略 429 回應。 試用金鑰允許 2 個並行請求,因此具有十個 worker 的迴圈會快速失敗。限制你的worker 數量或增加短暫等待。
- 發送過大的請求主體。 每個請求的限制為 8 MB。提示詞撰寫請求很小,所以這通常不重要,但貼上的文件可能會達到限制。
這些都不是難以修復的問題,最快的修復方法是在將任何內容連接至較大工具之前,執行一個十行的測試腳本。
何時其他服務更適合
對選擇保持務實。如果你需要圖片本身,你需要圖像供應商,OpenAI 是其中之一;查看其目前文件和定價以了解其提供的細節。如果你的唯一目標是獲得主流風格的清晰提示詞,標準助手可能就足夠了,你根本不需要此服務。
當文字步驟是瓶頸時,此 API 是更好的選擇:你使用的助手拒絕或柔化你的提示詞請求,你需要大量提示詞且每 token 價格可預測,或者你希望為合法成人用途的虛構、角色扮演和陪伴型工具獲得 OpenAI 相容端點,而無需重寫客戶端程式碼。如需完整參數詳細資訊,文件 包含請求格式和錯誤代碼。
另一個實用注意事項:發送至此 API 的提示詞不會用於訓練。不過,請將任何託管服務視為位於你的機器之外,避免發送你不會貼入網頁表單的機密資訊。
