接入文档 - VantAPI

快速开始

1. 注册账号并进入控制台。
2. 创建 API Key，并妥善保存完整密钥。
3. 选择模型，按文档示例发起请求。

OpenAI SDK 示例

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.VANTAPI_API_KEY,
  baseURL: process.env.VANTAPI_BASE_URL
});

const completion = await client.chat.completions.create({
  model: "gpt-5.4-mini",
  messages: [
    { role: "user", content: "用三句话介绍 VantAPI" }
  ],
  max_tokens: 800
});

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

HTTP 请求示例

curl "$VANTAPI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $VANTAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [{ "role": "user", "content": "你好" }],
    "max_tokens": 500
  }'

OpenAI 流式输出

设置 stream=true 后会以 SSE 持续返回内容；平台会在请求前检查余额，结束后按 usage 或已输出内容估算扣费。客户端主动断开、网络超时或取消时，如服务端已成功生成内容，仍可能按已产生用量扣费。

const stream = await client.chat.completions.create({
  model: "gpt-5.4-mini",
  messages: [{ role: "user", content: "写一段产品介绍" }],
  stream: true,
  stream_options: { include_usage: true }
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content || "");
}

Messages 接口示例

curl "$VANTAPI_BASE_URL/messages" \
  -H "Authorization: Bearer $VANTAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-7",
    "messages": [{ "role": "user", "content": "给我一份上线检查清单" }],
    "max_tokens": 800,
    "stream": true
  }'

常用接口

接口	方法	说明
/v1/models	GET	查看当前账号可用模型列表
/v1/chat/completions	POST	OpenAI 兼容对话接口
/v1/messages	POST	Messages 风格对话接口

控制台能力

团队与项目

可按团队、项目管理 API Key、成员角色和调用归属。

充值与支付状态

提交订单后可查看核对进度、支付状态、账单流水和余额变化。

工单反馈

订单、账单、接口接入和账号问题都可在控制台提交并持续跟进。

计费规则

账户额度

人民币付款后入账为平台美元额度，模型价格按美元 / 百万 Token 展示。

1K 起算

输入和输出 Token 分别按 1K Token 向上取整后计费。

最低消费

单次有有效用量的请求最低扣 0.01 美元额度。

长上下文请求

长上下文和大输出请求会按实际模型资源消耗计费，请按控制台账单明细核对。

服务稳定性

平台会根据模型状态和服务质量自动选择可用服务通道。

赠送额度

套餐赠送额度 30 天有效，并在消费时优先抵扣。

错误码与额度

401 invalid_api_key

API Key 缺失、错误、禁用或过期。

402 insufficient_balance

账户余额不足或预计请求费用超过余额。

403 permission_denied

当前账号无权访问指定团队、项目、密钥或工单。

404 ticket_not_found

工单不存在，或不属于当前账号可访问范围。

409 payment_pending

订单仍在核对或等待支付回调处理，请稍后查看状态。

429 rate_limit_exceeded

请求频率过高，请稍后重试或降低并发。

400 unsupported_stream_format

流式请求格式不符合当前兼容接口要求。

503 channel_unavailable

当前模型暂无可用服务渠道，请稍后重试或切换模型。

客户支持

订单问题

在控制台充值订单里复制 VantAPI 订单号，附付款平台订单号和付款截图提交反馈。

接口问题

提交模型名、调用时间、请求 ID、状态码和脱敏错误信息，避免粘贴完整 API Key。

账单复核

控制台工单会保留处理记录，平台按调用记录、账单流水和订单凭证复核。

接入建议

不要在浏览器前端、公开仓库或日志里暴露完整 API Key。
生产环境建议设置请求超时、失败重试和业务侧限流。
流式请求如果客户端主动断开，平台会停止继续转发并记录本次调用状态；已成功生成的内容可能产生费用。
大输出任务请合理设置 max_tokens，避免一次请求超过账户余额。
如需更高稳定性，请优先选择控制台标记为可用的模型，并关注调用记录里的状态和错误信息。
调用记录、Token 用量、支付状态、工单进度和账单流水可在控制台查询。

VantAPI 接入文档