API Docs

把 Wetoken 当作 OpenAI-compatible API 使用。

用一套 Base URL 和 sk Key 调用已接入的模型能力。用户、余额、API Key 和调用日志由 Wetoken 控制台统一管理。

Base URL

http://localhost:3000/v1

curl http://localhost:3000/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      { "role": "user", "content": "ping" }
    ]
  }'

Quick Start

快速接入

如果你的代码已经使用 OpenAI SDK，通常只需要替换 baseURL 和 apiKey。

创建账号

创建 API Key

按项目创建 sk Key，必要时设置额度上限。

替换 Base URL

把 SDK 指向 Wetoken 的 /v1 兼容端点。

查看用量

调用后在控制台查看日志、Token 和消耗。

Endpoints

常用端点

模型调用直接请求 API 域名；用户后台接口由 Portal BFF 转发，不建议浏览器直接调用受保护接口。

POST/v1/chat/completions

文本、对话和推理模型调用

POST/v1/embeddings

向量、搜索和知识库场景

GET/api/status

读取公开系统配置和登录开关

GET/api/user/self

登录用户信息，由 Portal 服务端转发

SDK

OpenAI SDK 示例

以下示例展示服务端调用方式。不要把 sk Key 暴露在浏览器端代码中。

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.WETOKEN_API_KEY,
  baseURL: "http://localhost:3000/v1"
});

const response = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "Hello Wetoken" }]
});

生产接入建议

真正上线时，接口能跑通只是第一步。Key、预算和日志策略同样重要。

按项目拆分 Key

不同业务、环境和任务使用不同 API Key，方便暂停和追踪。

服务端保存密钥

sk Key 只应该出现在服务端环境变量、密钥管理或任务系统中。

保留模型切换空间

业务代码不要写死过多供应商细节，模型可用性以后端为准。

文档常见问题

Base URL 是什么？

生产环境通常是 https://api.wetoken.one/v1，本地开发可以使用 http://localhost:3000/v1。

浏览器能直接调用 /v1 吗？

不建议。模型调用应该由服务端发起，避免把 API Key 暴露给用户。

用户后台为什么走 /api/newapi/*？

Portal 使用 BFF 转发受保护接口，保存 HttpOnly session，避免浏览器直接处理后端会话。

创建 API Key

http://localhost:3000/v1

创建 API Key