繁中 ▾
取得 API 金鑰

Flux API 金鑰:定義與文字 API 的定位

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

更新

兩組獨立金鑰,一組連結影像框架,一組連結聊天對話框,兩組獨立 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。這就是整個設定過程。

取得 API 金鑰