Flux API 金鑰:定義與文字 API 的定位
Flux API 金鑰是影像產生服務的憑證,本站不販售此類金鑰。本站販售的是另一種金鑰,用於託管的文字 LLM API,可為您輸入影像模型的提示詞進行撰寫與擴充。
更新

重點摘要
- Flux 影像服務的金鑰與文字 LLM API 的金鑰是兩回事,由兩個不同的供應商發行。
- 本站僅提供文字服務:不支援影像、音訊或影片生成,且並非由任何影像模型供應商營運。
- 由於提示詞撰寫屬於文字任務且按 token 計費,因此文字金鑰在搭配影像金鑰使用時很有用。
- 你只需在任意 OpenAI 相容客戶端中更改 Base URL 和金鑰即可開始使用,試用額度可涵蓋首次測試。
人們通常所指的 Flux 金鑰
Flux 是一系列文字轉影像模型的總稱。當有人在搜尋框輸入 flux api key 時,他們幾乎總是想要一個憑證,讓程式碼能將提示詞傳送至託管這些影像模型之一的服務,並取得圖片。該憑證來自你選擇的影像端點所屬的公司。它與該公司的帳戶、計費方式及其條款綁定。
你會看到該詞語以幾種略有不同的方式使用,在將金鑰貼到任何地方之前,釐清它們很有幫助:
- 來自提供 Flux 模型的影像主機的金鑰,用於會回傳影像的請求。
- 用於本地或自託管設定的金鑰,由你自行建立 token,且所有資料都不會離開你的機器。
- 用於管線中其他工具的金鑰,例如撰寫提示詞的文字模型,僅因為專案命名為 Flux 而得名。
只有前兩種會產生圖片。第三種是本站的定位。我們運作一個託管的 OpenAI 相容 LLM API,你在此獲得的金鑰僅適用於該 API,不適用於其他任何服務。
為何影像金鑰無法呼叫聊天模型
這兩種金鑰看起來相似,因為它們都是你在 Authorization 標頭中傳送的一長串字元,但它們開啟不同的門戶。影像提供者的金鑰由影像提供者檢查。如果你將其傳送至聊天端點,你會收到驗證錯誤,反之亦然:來自本站的金鑰在傳送至影像主機時也會回傳錯誤。
請求主體也不同。影像呼叫通常包含提示詞、尺寸、種子值和圖片數量。聊天呼叫包含帶有角色的訊息列表,並回傳文字。沒有共享的 schema,因此沒有東西可以轉換。如果你有針對影像主機運作的腳本,請保持該腳本和金鑰不變。在它前面新增一個獨立的文字呼叫步驟。
此服務不提供的功能
為了讓期望清晰:此 API 僅限文字。它不產生影像、音訊或影片,不建立嵌入向量,也不提供微調。它不是任何模型供應商的官方 API,也不是跨供應商的路由器。它服務一個開放權重模型,針對合法成人用途進行調整,使其在回答時不會拒絕內容,由獨立提供者營運。你傳送的模型 ID 是 uncensored。
文字 API 在影像金鑰旁的定位
提示詞撰寫是顯著的結合點。影像模型對具體、結構化的描述反應良好:主體、場景、鏡頭、燈光、顏色、情緒。大多數人手寫這些描述,然後在結果不佳後重新改寫。文字模型可以完成初稿,將三個詞的想法擴充為完整描述,或在你去喝咖啡時產生二十種變體。
以下幾項工作非常適合:
- 擴充。 將簡短的想法轉為你已在系統訊息中設定風格的詳細提示詞。
- 變體。 要求針對單一主題的十種不同版本,以 JSON 列表形式回傳,供你的腳本迴圈遍歷。
- 清理。 將客戶撰寫的雜亂提示詞改寫為影像模型更容易處理的形式。
- 腳本與說明。 撰寫旁白、鏡頭清單或圖片旁的說明文字。
由於此模型預設不會拒絕,因此適合小說、角色設計和成熟主題,其他託管模型通常會拒絕這些內容,只要用途合法且涉及成人即可。有一個硬性限制適用於所有情況:禁止涉及未成年人的性內容。此類請求是我們以任何形式都不支援的。
一分鐘內完成首次呼叫
只要更換 Base URL 和金鑰,任何 OpenAI SDK 或 HTTP 客戶端均可運作。聊天端點為 POST /v1/chat/completions,GET /v1/models 列出模型。以下是 curl 和 Python 中的相同請求。
curl https://api.fluxapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You write detailed image prompts. Reply with the prompt only."},
{"role": "user", "content": "a lighthouse in a storm, painterly"}
]
}'
from openai import OpenAI
client = OpenAI(
base_url="https://api.fluxapikey.com/v1",
api_key="YOUR_KEY",
)
reply = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You write detailed image prompts. Reply with the prompt only."},
{"role": "user", "content": "a lighthouse in a storm, painterly"},
],
)
print(reply.choices[0].message.content)
回傳的任何字串都是你要交給影像服務的內容,使用該服務自己的金鑰。兩者從不互相接觸。如需完整參數列表,包括串流輸出、函式呼叫和 JSON 模式,請參閱 API 文件。
你是否需要兩組金鑰?
取決於你正在建構的內容。下表是快速決定的方法。
| 你的目標 | 影像金鑰 | 文字金鑰 |
|---|---|---|
| 從你手寫提示詞產生圖片 | 是 | 否 |
| 從模型撰寫或擴充的提示詞產生圖片 | 是 | 是 |
| 僅撰寫故事、對話或腳本 | 否 | 是 |
| 為成人建構聊天或角色扮演應用程式 | 否 | 是 |
| 批次產生數百種提示詞變體 | 選配 | 是 |
如果你只輸入自己的提示詞且對其滿意,文字金鑰的附加價值有限。如果你發現自己整個下午都在重寫提示詞,或需要大量產出,它會很快賺回成本。我們還有一份關於 在影片工作流程中使用文字 LLM 的簡短指南,遵循相同的理念:在媒體步驟之前加入文字步驟。
混淆金鑰會造成的錯誤
在兩項服務設定中,大多數問題都很小,一旦你知道要尋找什麼,就容易發現。
- 錯誤的 Base URL。 如果你的客戶端仍指向舊主機,新金鑰會被拒絕。檢查 Base URL 是否以
/v1結尾,並與上述範例匹配。 - 錯誤的模型名稱。 此處唯一的模型 ID 是
uncensored。傳入影像模型的名稱會回傳錯誤,因為此 API 上沒有該模型。 - 金鑰放在同一個環境變數中。 為每個服務提供各自的變數,例如
TEXT_API_KEY和IMAGE_API_KEY。共用同一個名稱是金鑰被傳送至錯誤主機的成因。 - 期望在回覆中看到圖片。 回覆是
choices[0].message.content中的純文字。如果你需要圖片,該文字必須作為第二次呼叫傳送至你的影像服務。 - 忽略 429。 超過 8 個並行請求會回傳 429 錯誤,錯誤代碼為
concurrency;超過每分鐘 300 個請求則為rate_limited。稍作退避並重試。串流請求會佔用其槽位直到串流結束,因此請關閉你不再讀取的串流。
試用金鑰的限額較低:2 個並行請求和每分鐘 60 個。這足以手動測試提示詞撰寫步驟,但大量批次應等待儲值後的金鑰。
撰寫提示詞的成本
計費方式為按 token 計費且採預付制:輸入 token 每 100 萬個 $0.15,輸出 token 每 100 萬個 $0.50,無訂閱費。提示詞任務通常很小,因此費用很低。舉例來說,一個請求包含 600 個 token 的系統訊息加提示詞(輸入)以及 250 個 token 的擴展提示詞(輸出)。輸入成本為 600 / 1,000,000 x $0.15 = $0.00009。輸出成本為 250 / 1,000,000 x $0.50 = $0.000125。單一請求總計 $0.000215。
因此,1,000 筆此類請求的成本約為 $0.215。$0.50 的試用額度(註冊後可在金鑰頁面一鍵領取)可涵蓋約 2,300 筆請求(0.50 / 0.000215)。無需信用卡即可領取,且有效期為 7 天。失敗或被拒絕的請求不會計費,之後儲值的額度永不過期。詳情請見 定價頁面。
取得您的文字金鑰
使用 Google 帳號或電子郵件與密碼註冊,然後開啟 API 金鑰頁面。若想先進行測試,可在此領取試用額度。付費儲值金額範圍為 $20 至 $500,可為任意整數金額;儲值 $50 起贈送 +5%,$100 起贈送 +10%,$200 起贈送 +15%。支援加密貨幣(TRC20 網路上的 USDT、Base 網路上的 USDC)付款。
請將金鑰保留在客戶端程式碼與公開程式碼庫之外。您發送的提示詞不會用於模型訓練,但金鑰外洩將導致您的額度被消耗。完整金鑰允許 8 個並行請求與每分鐘 300 個請求,因此提示詞批次可在無需額外設定的情況下並行執行。
更多指南
問答
我可以使用此金鑰為 Flux 生成圖片嗎?
不行。此金鑰僅適用於本站的文字 API。圖片生成需要來自託管圖片模型的供應商所發行的金鑰。
這是官方的 Flux API 嗎?
不是。這是一個獨立的託管式 OpenAI 相容文字 API,僅有一個模型,名為 uncensored。它不由任何圖片模型供應商運營,也不轉售他們的服務。
文字模型可以為我的圖片工具撰寫提示詞嗎?
可以。在系統訊息中要求提示詞,取得回覆文字後,將其貼上或傳送至您的圖片服務即可。兩項服務保持獨立運作。
試用時需要綁定信用卡嗎?
不會。新用戶可在金鑰頁面一鍵領取 $0.50 試用額度,有效期 7 天,無需綁定信用卡。
只差一張表單,即可取得金鑰
建立帳號、複製金鑰、更改 Base URL。這就是整個設定過程。