VantAPI 接入文档

使用说明

未登录时这里只展示通用接入方法；完整 API Key、账户余额、调用记录和账单明细只在登录控制台后显示。

1. 1. 注册并登录控制台，进入“API 密钥”页面。
2. 2. 创建 API Key，密钥卡片会长期保留；平时脱敏显示，需要时可显示并复制完整密钥。
3. 3. 在 SDK、Postman、Apifox 或业务服务里填写 Base URL：https://vantapi.com/v1。
4. 4. 在请求头填写 Authorization: Bearer 你的完整 API Key，选择模型后发起请求。

连接参数怎么填

先测试能不能连通

把下面示例里的 sk-替换成你的完整APIKey 改成控制台生成的完整密钥，即可测试模型列表接口。

curl "https://vantapi.com/v1/models" \
  -H "Authorization: Bearer sk-替换成你的完整APIKey"

发送第一条对话请求

连通后再调用对话接口。下面是最小可用示例，适合终端、本地脚本或服务端测试。

curl "https://vantapi.com/v1/chat/completions" \
  -H "Authorization: Bearer sk-替换成你的完整APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      { "role": "user", "content": "你好，请介绍一下 VantAPI" }
    ],
    "max_tokens": 500
  }'

生成图片

图片模型使用 OpenAI 兼容 Images API，不要发到对话接口。实际扣费会按模型、提示词、图片张数、尺寸和质量折算。

curl "https://vantapi.com/v1/images/generations" \
  -H "Authorization: Bearer sk-替换成你的完整APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "一张现代 API 控制台风格的产品海报",
    "n": 1,
    "size": "1024x1024"
  }'

生成视频

视频模型使用 VantAPI Videos API。你只需要使用自己的 VantAPI API Key，不需要在业务代码里接触上游 fal.ai 密钥；实际扣费按模型、提示词、时长、清晰度和生成数量折算。

curl "https://vantapi.com/v1/videos/generations" \
  -H "Authorization: Bearer sk-替换成你的完整APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan-video",
    "prompt": "电影感镜头：霓虹雨夜里，一辆红色跑车穿过城市街道，镜头缓慢推进",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

在代码里接入

服务端项目建议把完整 API Key 放到环境变量里，不要写进前端页面、公开仓库或日志。

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.VANTAPI_API_KEY,
  baseURL: "https://vantapi.com/v1"
});

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

const image = await client.images.generate({
  model: "gpt-image-1",
  prompt: "一张现代 API 控制台风格的产品海报",
  size: "1024x1024"
});

const video = await fetch("https://vantapi.com/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VANTAPI_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "wan-video",
    prompt: "电影感镜头：霓虹雨夜里，一辆红色跑车穿过城市街道",
    duration: 5,
    resolution: "720p",
    aspect_ratio: "16:9"
  })
}).then((res) => res.json());

console.log(completion.choices[0].message.content);
console.log(image.data[0]);
console.log(video.data?.[0] || video);

流式输出怎么用

需要边生成边显示时，把 stream 设为 true。适合聊天窗口、长文本生成和需要实时展示结果的场景。

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

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

接口路径说明

登录后在哪里操作

计费和使用注意

常见报错怎么处理

需要人工协助时