VLX FLUX

简体中文

English

简体中文

English

Appearance

快速开始 ​

这篇教程帮助你用 VLX FLUX 完成第一次成功请求。它面向购买分发 API 的用户，适用于代码调用、CLI 工具和支持 OpenAI 兼容接口的第三方客户端。

你需要准备什么 ​

开始前，请确认你已经具备：

  • VLX FLUX 账号
  • 可用的 API Key
  • 可用余额或试用额度
  • 当前账号可调用的模型

Base URL 为：

text
https://api.vlxflux.io/v1

第一步：创建 API Key ​

登录 VLX FLUX 控制台，创建一个 API Key。

请妥善保管 API Key。任何拿到该 Key 的人都可以发起请求，并可能消耗你的账户余额。

如果你已经有 API Key，可以直接进入下一步。

第二步：确认 Base URL ​

在 SDK、CLI 工具和第三方客户端中，使用下面的 Base URL：

text
https://api.vlxflux.io/v1

常见错误：

  • 客户端要求 /v1 后缀时，不要只填写 https://api.vlxflux.io。
  • 不要重复填写版本路径，例如 /v1/v1。
  • 不要把控制台网页地址当作 API 地址。

第三步：查询可用模型 ​

先通过模型列表接口确认当前 Key 能调用哪些模型：

bash
curl https://api.vlxflux.io/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

请把 YOUR_API_KEY 替换为你自己的 API Key。

如果请求成功，你会看到模型 ID 列表。后续请求请使用列表中的模型名。

第四步：发送第一条聊天请求 ​

使用当前账号可调用的模型名：

bash
curl https://api.vlxflux.io/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      { "role": "user", "content": "请用一句话打个招呼。" }
    ]
  }'

如果接口正常返回助手消息，说明 API Key、Base URL、模型名和账户余额都可以正常使用。

第五步：使用 SDK ​

Python 示例：

python
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.vlxflux.io/v1"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "user", "content": "请用一句话打个招呼。"}
    ]
)

print(response.choices[0].message.content)

Node.js 示例：

js
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.VLXFLUX_API_KEY,
  baseURL: "https://api.vlxflux.io/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [
    { role: "user", content: "请用一句话打个招呼。" },
  ],
});

console.log(response.choices[0].message.content);

第六步：配置第三方客户端 ​

支持 OpenAI 兼容接口的客户端通常按下面填写：

字段填写内容
API Key你的 VLX FLUX API Key
Base URLhttps://api.vlxflux.io/v1
Model当前账号可调用的模型名

不同客户端的字段名称可能不同，例如 OpenAI Compatible API、Custom API Endpoint、API Host、Base URL，通常都表示同一类配置。

第七步：查看计费 ​

每次成功请求可能会根据以下因素扣费：

  • 所选模型
  • 输入和输出 Token 用量
  • 模型分组倍率
  • 控制台实时展示的价格

你可以在控制台查看余额、消费记录和模型价格。

快速排查 ​

现象优先检查
401 UnauthorizedAPI Key 是否缺失、错误、被禁用，或带有多余空格
403 Forbidden当前 Key 是否有权限调用所选模型或分组
404 Not FoundBase URL 或请求路径是否错误
429 Too Many Requests请求频率或并发数是否过高
model not found模型名是否错误，或当前账号不可用
余额不足充值账户，或切换到成本更低的模型

延伸阅读 ​