中文 ▾
获取 API 密钥

Flux API 密钥:它是什么,文本 API 如何定位

Flux API 密钥是图像生成服务的凭证,而本站不出售此类密钥。本站出售的是另一种密钥,用于托管文本 LLM API,该 API 可以编写和扩展你输入给图像模型的提示词。

更新于

两个独立的密钥,一个关联图像框架,一个关联聊天气泡,对应两个独立的 API

要点

  • 图像服务的密钥和文本 LLM API 的密钥是两回事,由两个不同的提供商签发。
  • 本网站仅提供文本服务:不提供图像、音频或视频生成,且并非由任何图像模型供应商运营。
  • 文本密钥与图像密钥配合使用很有用,因为编写提示词是文本任务,按 token 计费。
  • 你只需更改任何 OpenAI 客户端中的一个 Base URL 和一个密钥即可开始,试用额度可覆盖首次测试。

人们通常所指的 Flux 密钥

Flux 是一系列文生图模型的名字。当有人在搜索框中输入 flux api key 时,他们几乎总是想要一个凭证,让他们的代码向托管这些图像模型之一的服务发送提示词并获取图片。该凭证来自你选择的图像接口所属的公司。它与他们的账户、账单和条款绑定。

你会看到该短语以几种略有不同的方式使用,在将密钥粘贴到任何地方之前,理清它们很有帮助:

  • 来自提供 Flux 模型的图像主机的密钥,用于返回图像的请求。
  • 用于本地或自托管设置的密钥,你自行创建 token,且没有任何数据离开你的机器。
  • 用于管道中其他工具的密钥,例如编写提示词的文本模型,仅因为项目命名为 Flux 而被调用。

只有前两种能生成图片。本站属于第三种。我们运营一个托管的 OpenAI 兼容 LLM API,你在此获得的密钥仅适用于该 API,不适用于其他任何服务。

为何图像密钥无法调用聊天模型

这两类密钥看起来相似,因为它们都是你在 Authorization 标头中发送的长字符串,但它们打开的是不同的门。图像提供商的密钥由图像提供商检查。如果你将其发送到聊天接口,你会收到身份验证错误,反之亦然:来自本站的密钥如果发送到图像主机,也会返回错误。

请求体也不同。图像调用通常包含提示词、尺寸、种子值和图片数量。聊天调用包含带有角色的消息列表,并返回文本。没有共享的模式,因此两者之间没有可翻译的内容。如果你有针对图像主机运行的脚本,请保持该脚本及其密钥完全不变。在其前面添加文本调用作为单独的步骤。

该服务不做什么

为了明确预期:此 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 个并发请求会返回带有错误代码 concurrency 的 429,超过每分钟 300 个请求会返回 rate_limited。稍作退避并重试。流式请求会占用其槽位直到流结束,因此请关闭你不再读取的流。

试用密钥的限额较低:2 个并发请求和每分钟 60 个。这对于手动测试提示词编写步骤来说已经足够,但大批量生成应等待充值后的密钥。

提示词编写成本

计费按 token 计算,采用预付模式:输入 token 每 100 万 token 收费 $0.15,输出 token 每 100 万 token 收费 $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 的免费试用额度,你可以在注册后在 API 密钥页面一键领取,足以覆盖约 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 的模型。它不由任何图像模型供应商运营,也不转售他们的服务。

文本模型可以为我的图像工具编写提示词吗?

可以。在系统消息中要求生成提示词,获取回复文本,然后将其粘贴或发送到你的图像服务。这两项服务保持独立。

试用需要绑定银行卡吗?

不需要。新用户可以在 API 密钥页面一键领取 $0.50 的免费试用额度,有效期 7 天,无需绑定银行卡。

只差一张表单,即可获得密钥

创建账户,复制密钥,更改 Base URL。这就是全部设置。

获取 API 密钥