API 文档

一个 OpenAI 兼容端点,用 DeepSeek、Qwen、GLM。改 base_url 就好,代码不用改。

快速开始

Python(openai SDK)

pip install openai

from openai import OpenAI

client = OpenAI(
    base_url="https://vantixcloud.com/v1",
    api_key="vx-your-key",
)

r = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{"role": "user", "content": "Hello"}],
)
print(r.choices[0].message.content)

Node.js(openai SDK)

npm install openai · ES modules(顶层 await)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://vantixcloud.com/v1",
  apiKey: process.env.VANTIX_KEY, // vx-...
});

const r = await client.chat.completions.create({
  model: "deepseek-flash",
  messages: [{ role: "user", content: "Hello" }],
});
console.log(r.choices[0].message.content);

curl

curl https://vantixcloud.com/v1/chat/completions \
  -H "Authorization: Bearer $VANTIX_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-flash","messages":[{"role":"user","content":"Hello"}]}'

流式输出

设 stream: true 就会收到标准 OpenAI 格式的 SSE。网关会向上游请求流式的 token 用量(stream_options.include_usage),所以最后一个 chunk 带有 usage,余额就是按此扣费。

Python

stream = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{"role": "user", "content": "Write a haiku about latency"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
    if chunk.usage:  # last chunk carries token usage
        print("\n", chunk.usage)

Node.js

const stream = await client.chat.completions.create({
  model: "deepseek-flash",
  messages: [{ role: "user", content: "Write a haiku about latency" }],
  stream: true,
});
for await (const chunk of stream) {
  const t = chunk.choices?.[0]?.delta?.content;
  if (t) process.stdout.write(t);
  if (chunk.usage) console.log("\n", chunk.usage); // last chunk
}

curl

curl -N https://vantixcloud.com/v1/chat/completions \
  -H "Authorization: Bearer $VANTIX_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-flash","stream":true,"messages":[{"role":"user","content":"Hello"}]}'

模型

模型 ID 区分大小写。以下是目前端点上的模型;GET /v1/models 返回同一份列表。

curl https://vantixcloud.com/v1/models

Kimi、Seedance 2.5、Wan,以及 Claude、GPT、Gemini 为报价制供应,不在这个端点的固定列表上。想按官方牌价比较每月费用,请用大模型 API 费用计算器。

查余额与用量

把 key POST 到 /api/keys,带 action: "balance",会返回余额、累计花费与调用次数(美元)。非流式响应也会带两个响应头:

流式响应不带这两个响应头,请用查余额。

curl -X POST https://vantixcloud.com/api/keys \
  -H "Content-Type: application/json" \
  -d '{"action":"balance","key":"vx-your-key"}'

# {"ok":true,"email":"...","balance":12.3456,"spent":7.6544,"calls":1234,"created":"..."}

错误码

错误采用 OpenAI 的错误格式,SDK 会照常抛出异常:

{"error": {"message": "Insufficient balance. Top up at ...", "type": "invalid_request_error"}}

频率限制

网关本身不设每把 key 的频率限制。上游供应商有各自的限制;它们返回 429 时我们原样返回。请用指数退避重试:

import time, openai

def call_with_retry(fn, tries=5):
    for i in range(tries):
        try:
            return fn()
        except openai.RateLimitError:          # HTTP 429 passed through from upstream
            time.sleep(min(2 ** i, 30))
        except openai.APIStatusError as e:     # retry 502/503 only
            if e.status_code not in (502, 503):
                raise
            time.sleep(min(2 ** i, 30))
    raise RuntimeError("still failing, contact Telegram @sapporo168")

接入各种工具

只要支持“OpenAI 兼容”供应商的工具都能用:填 base URL、粘贴 key、选模型 ID。

Cline / Roo Code (VS Code)

• API Provider:OpenAI Compatible
• Base URL:https://vantixcloud.com/v1
• API Key:vx-…
• Model ID:deepseek-v4-pro 或 deepseek-flash

LibreChat

# librechat.yaml
endpoints:
  custom:
    - name: "VantixCloud"
      apiKey: "${VANTIX_KEY}"
      baseURL: "https://vantixcloud.com/v1"
      models:
        default: ["deepseek-flash", "deepseek-v4-pro", "qwen3.7-plus", "glm-5.3"]
        fetch: true
      titleConvo: true
      modelDisplayLabel: "VantixCloud"

Cherry Studio / ChatBox / NextChat

• 供应商类型:OpenAI
• API 地址:https://vantixcloud.com(有些 App 要不含 /v1 的地址;失败就改成加 /v1)
• API Key:vx-…
• 手动添加模型:deepseek-flash、deepseek-v4-pro、qwen3.8-max、glm-5.3

one-api / new-api

• 渠道类型:OpenAI
• Base URL:https://vantixcloud.com
• Key:vx-…
• 模型:粘贴上方的 ID

LangChain

from langchain_openai import ChatOpenAI
llm = ChatOpenAI(model="deepseek-flash", base_url="https://vantixcloud.com/v1", api_key="vx-...")

故障排查