大模型 API 接入指南｜向量潮汐 / Vectide

平台能力

围绕"接入即用"的核心目标，向量潮汐提供以下六项能力。

🔀

多模型聚合一个入口汇聚 GLM、DeepSeek、Kimi、MiniMax 等厂商模型，随时切换，无需重复对接。

🔑

统一密钥一个 API Key 通行全平台模型，集中管理调用凭据，告别多套密钥的维护负担。

🧩

OpenAI 兼容提供 OpenAI 兼容接入；具体接口、参数与客户端功能需按所选模型分别验证。

🛠️

工具即插即用提供多种客户端配置参考；工具版本、接口协议与模型权限需在当前账号中验证。

📊

用量与计费透明控制台实时查看调用量、消费明细与额度趋势，套餐与加油包灵活组合。

⚡

高可用网关统一网关调度上游渠道，支持限流与重试，保障调用稳定与响应速度。

支持的模型

按当前套餐目录填写准确模型 ID。型号、模型权限与 TokenPlan 倍率分别核对；接入某个型号不代表所有接口和多模态能力均已开放。

GLM ↗GLM-5.3、GLM-5.2 与 GLM-5.3 Flash 的包含关系。DeepSeek ↗V4 Pro、V4 Flash 与 V4.1 Flash 的准确模型 ID。Kimi ↗Kimi K3 的档位、额度与模型 ID。

查看完整 CodingPlan 目录 · 查看 TokenPlan 模型倍率

套餐总览

向量潮汐提供两种使用模式：CodingPlan 周期卡按模型系列订阅，可选择月卡、季卡或年卡，并同时享有 5 小时固定时段额度与周限额；TokenPlan 加油包按 Token 额度购买，用完为止，适合周期卡额度不够时的灵活补充。

CodingPlan 周期卡月卡 / 季卡 / 年卡可选，含 5 小时额度与周限额

TokenPlan 加油包按 Token 额度购买，不限模型，用完为止

统一 API 入口所有套餐共用同一个 Base URL 与 API Key

选择建议：如果你主要使用某个模型（如 GLM-5.3），选择对应 CodingPlan 套餐更划算；如果多模型混用或用量波动大，TokenPlan 加油包更灵活。两者可以同时持有、叠加使用。

CodingPlan 周期卡

CodingPlan 当前在售套餐如下，支持月卡、季卡和年卡。价格、模型范围、5 小时限额及周限额与购买页面同步。已购套餐保留各自权益，以控制台显示为准。

计费说明：月卡有效 30 天；季卡有效 90 天，默认按月价 × 3 × 9 折；年卡有效 360 天，默认按月价 × 12 × 8 折。达到 5 小时窗口上限或周限额后，需要等待对应额度周期恢复。

Google Gemini 3.8 Flash

Gemini 3.8 Flash 提供标准版、Plus 版与 Max 版，价格和额度与 Kimi K3 相同。

API 模型名：gemini-3.8-flash-high · Base URL：https://vectide.cn/v1

支持流式输出、工具调用与 Responses 接口。

Gemini 使用独立 CodingPlan，国产大模型通卡不包含此模型。

查看 Gemini 套餐

点击价格，在购买页查看该套餐与周期。

人民币各周期总价 · 套餐目录核对于 2026-10-14
套餐 / 标识	月卡 · 30 天	季卡 · 90 天	年卡 · 360 天	5 小时 / 每周	支持的模型 ID
glm5.3月卡-标准版`glm`	¥89.80	¥242.46	¥862.08	500 / 5,000	`glm-5.2` `glm-5.3`
glm5.3月卡-max版`glmmax`	¥135.80	¥366.66	¥1303.68	1,000 / 10,000	`glm-5.2` `glm-5.3`
glm5.3月卡-ultra版`glm53ultra`	¥199.80	¥539.46	¥1918.08	1,500 / 15,000	`glm-5.2` `glm-5.3`
deepseekv4pro0813正式版-标准版`deepseekv4`	¥59.80	¥161.46	¥574.08	250 / 2,500	`deepseek-v4-flash-0731` `deepseek-v4-pro-0813`
deepseekv4pro0813正式版-Plus版`deepseekv4plus`	¥89.80	¥242.46	¥862.08	500 / 5,000	`deepseek-v4-flash-0731` `deepseek-v4-pro-0813`
deepseekv4pro0813正式版-max版`deepseekv4promax`	¥139.80	¥377.46	¥1342.08	1,000 / 10,000	`deepseek-v4-flash-0731` `deepseek-v4-pro-0813`
MiniMax-M3月卡-标准版`minimaxm3`	¥59.80	¥161.46	¥574.08	1,000 / 10,000	`MiniMax-M2` `MiniMax-M2.1` `MiniMax-M2.1-highspeed` `MiniMax-M2.5` `MiniMax-M2.5-highspeed` `MiniMax-M2.7` `MiniMax-M2.7-highspeed` `MiniMax-M3`
MiniMax-M3月卡-plus版`minimaxm3plus`	¥89.80	¥242.46	¥862.08	1,500 / 15,000	`MiniMax-M2` `MiniMax-M2.1` `MiniMax-M2.1-highspeed` `MiniMax-M2.5` `MiniMax-M2.5-highspeed` `MiniMax-M2.7` `MiniMax-M2.7-highspeed` `MiniMax-M3`
Kimi-k3月卡-标准版`kimi26`	¥89.80	¥242.46	¥862.08	250 / 2,500	`kimi-k3`
Kimi-k3月卡-plus版`kimiplus`	¥139.80	¥377.46	¥1342.08	500 / 5,000	`kimi-k3`
Kimi-k3月卡-max版`kimimax`	¥199.80	¥539.46	¥1918.08	1,000 / 10,000	`kimi-k3`
国产大模型通用月卡`general`	¥259.00	¥699.30	¥2486.40	1,000 / 10,000	`MiniMax-M2.1-highspeed` `MiniMax-M2.5` `MiniMax-M2.5-highspeed` `MiniMax-M2.7` `MiniMax-M2.7-highspeed` `MiniMax-M3` `deepseek-v4-flash-0731` `deepseek-v4-pro-0813` `glm-5.2` `glm-5.3` `kimi-k3`
deepseekv4flash0731正式版-标准版`v4flash0731`	¥49.80	¥134.46	¥478.08	500 / 5,000	`deepseek-v4-flash-0731`
deepseekv4flash0731正式版-Plus版`v4flashplus`	¥89.80	¥242.46	¥862.08	1,000 / 10,000	`deepseek-v4-flash-0731`
glm5.2月卡-标准版`glm52`	¥65.80	¥177.66	¥631.68	500 / 5,000	`glm-5.2`
glm5.2月卡-max版`glm52max`	¥99.80	¥269.46	¥958.08	1,000 / 10,000	`glm-5.2`
GLM5.2轻量版`glm52lite`	¥59.80	¥161.46	¥574.08	250 / 2,500	`glm-5.2`
deepseekv4.1flash-体验版`deepseekv41flash`	¥59.80	¥161.46	¥574.08	500 / 5,000	`deepseek-v4.1-flash`
deepseekv4.1flash-标准版`deepseekv41flashplus`	¥89.80	¥242.46	¥862.08	1,000 / 10,000	`deepseek-v4.1-flash`
MimoV2.6Flash月卡标准版`mimo26flash`	¥59.90	¥161.73	¥575.04	500 / 5,000	`mimo-v2.6-flash`
MimoV2.6Flash月卡PLUS版`mimov26flashpro`	¥89.90	¥242.73	¥863.04	1,000 / 10,000	`mimo-v2.6-flash`
MimoV2.6flash月卡max版`mimov26flashmax`	¥129.80	¥350.46	¥1246.08	2,000 / 20,000	`mimo-v2.6-flash`
GLM-5.3 Flash Lite 版`glm53flashlite`	¥59.80	¥161.46	¥574.08	250 / 2,500	`glm-5.3-flash`
GLM-5.3 Flash 标准版`glm53flash`	¥65.80	¥177.66	¥631.68	500 / 5,000	`glm-5.3-flash`
GLM-5.3 Flash Max 版`glm53flashmax`	¥99.80	¥269.46	¥958.08	1,000 / 10,000	`glm-5.3-flash`
Gemini 3.8 Flash月卡-标准版`gemini38flash`	¥89.80	¥242.46	¥862.08	250 / 2,500	`gemini-3.8-flash-high`
Gemini 3.8 Flash月卡-Plus版`gemini38flashplus`	¥139.80	¥377.46	¥1342.08	500 / 5,000	`gemini-3.8-flash-high`
Gemini 3.8 Flash月卡-Max版`gemini38flashmax`	¥199.80	¥539.46	¥1918.08	1,000 / 10,000	`gemini-3.8-flash-high`

额度规则：5 小时额度在北京时间每天 00:00、05:00、10:00、15:00、20:00 刷新（20:00 至次日 00:00 为 4 小时），周限额按自然周累计。两类限制同时生效，具体数值以套餐卡片与控制台为准。

TokenPlan 加油包

TokenPlan 加油包按 Token 额度购买，不限定模型，用完为止，支持国产模型以及 GPT、GROK、Claude 海外模型系列。不同模型按控制台配置的调用倍率折算 Token 消耗；加油包购买后立即生效，与 CodingPlan 周期卡可同时持有。

入门包

适合轻量体验

2 亿

Tokens

¥30.00 一次性

Token 额度：200,000,000
适用模型：全系列通用
有效期：用完为止
适合：首次体验、轻度使用

高性价比

尊享包

高性价比大额度

10 亿

Tokens

¥100.00 一次性

Token 额度：1,000,000,000
适用模型：全系列通用
有效期：用完为止
适合：周期卡补充、高频多模型混用
单位成本比入门包低 33.3%

Token 消耗规则：倍率为 1x：deepseek-v4-flash-0731、glm-5.1、glm-5、MiniMax-M2.7；2x：deepseek-v4-pro-0813、MiniMax-M3、gpt-5.6-luna；3x：glm-5.2；4x：kimi-k3、gpt-5.6-terra、grok-4.5；6x：gpt-5.6-sol、grok-4.6、claude-opus-4.8；10x：claude-fable-5。模型与倍率以控制台最终配置为准，控制台"用量趋势"页面可查看 Token 消耗明细。

套餐对比

以下表格对比 CodingPlan 周期卡与 TokenPlan 加油包的核心差异，帮助你根据使用场景选择最合适的方案。

对比项	CodingPlan 周期卡	TokenPlan 加油包
计费方式	按 5 小时调用次数	按 Token 额度
有效期	30 / 90 / 360 天	用完为止，无过期
模型范围	绑定单个模型系列（通用卡除外）	全系列通用
额度恢复	北京时间固定时段刷新	消耗后不恢复
适合场景	固定模型、稳定频率使用	多模型混用、用量波动大
能否叠加	可同时持有多个周期卡	可与周期卡叠加使用
起售价格	¥49.80 起	¥30.00 起
调用优先级	周期卡额度优先消耗	周期卡用尽后消耗加油包

使用场景推荐

场景 A：重度单模型用户

主要使用 GLM-5.3 或 Kimi K3
每天调用 200~500 次
推荐：对应模型高额度套餐，可按月 / 季 / 年购买
周期卡额度不够时补充加油包

场景 B：多模型混用

不同任务用不同模型
需要灵活切换
推荐：国产大模型CodingPlan 通卡
或直接购买 TokenPlan 尊享包

场景 C：轻度体验

刚注册想试用
偶尔使用，频率不高
推荐：TokenPlan 入门包
30 元体验全部模型能力

快速开始

四步完成从注册到首次调用，几分钟即可将大模型接入你的应用。

注册账号：访问向量潮汐官网完成注册，绑定邮箱或手机号。
选购套餐：在控制台选择合适的套餐或加油包，获取可调用的模型额度。
创建 API Key：进入控制台密钥管理，生成形如 sk-vt-… 的 API Key 并妥善保存。
发起调用：将 Base URL 设为 https://vectide.cn/v1，填入 Key 与模型 ID，即可发送第一个请求。

CURL · 第一个请求

curl https://vectide.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-vt-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.3",
    "messages": [{"role": "user", "content": "你好，介绍一下你自己"}]
  }'

开发指南

向量潮汐兼容 OpenAI 接口协议，可在多种语言和框架中直接使用，无需专用 SDK。

HTTP API标准 RESTful 接口，任意语言均可通过 HTTP 请求直接调用。

OpenAI Python SDK安装官方 openai 库，仅需修改 base_url 与 api_key 两项。

OpenAI Node SDKJavaScript / TypeScript 项目同样通过官方 SDK 直接接入。

LangChain 集成作为 OpenAI 兼容端点接入 LangChain，构建复杂 AI 应用与智能体。

PYTHON · OpenAI SDK

from openai import OpenAI

client = OpenAI(
    api_key="sk-vt-your-key",
    base_url="https://vectide.cn/v1",
)

resp = client.chat.completions.create(
    model="glm-5.3",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

NODE.JS · OpenAI SDK

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-vt-your-key",
  baseURL: "https://vectide.cn/v1",
});

const resp = await client.chat.completions.create({
  model: "glm-5.3",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

核心概念

理解以下几个基础概念，有助于更好地使用向量潮汐平台。

API Key

调用平台的身份凭据，形如 sk-vt-…。请仅保存在可信设备，不要提交到 Git、聊天记录或公开截图中。一个 Key 可调用账号套餐内的全部模型。

Base URL

统一服务地址，固定为 https://vectide.cn/v1。请勿省略 /v1，也不要追加其他路径。所有 OpenAI 兼容工具均填此地址。

模型 ID

标识具体调用哪个模型，如 glm-5.2、deepseek-v4-pro-0813。请使用控制台套餐详情中显示的准确 ID，未包含在套餐内的模型无法调用。

Token 与用量

Token 是模型处理文本的基本单位；与中文字符或英文单词没有固定的一比一换算关系。每次请求消耗的 Token 数会计入用量，可在控制台"用量趋势"与"消费日志"中实时查看。

工具接入教程

无论你使用哪款工具，接入向量潮汐只需要三样东西：API Key、统一 Base URL 和模型 ID。配置完成后，所有工具共用同一个入口。

01 · API Key形如 sk-…，在控制台"我的 Key"页面创建。请只保存在可信设备。

02 · Base URL固定为 https://vectide.cn/v1。请勿省略 /v1。

03 · 模型 ID按已购套餐选择可用模型，如 glm-5.3、deepseek-v4-pro-0813 等。

安全提示：不要把真实 API Key 提交到 Git、聊天记录或公开截图中。示例里的 sk-vt-your-key 必须替换，但不要对外分享你的真实 Key。

TOOL 01

VS Code

在 VS Code 中通过 Cline 或 Claude Code 插件接入；两者均使用同一个 API Key 与统一 Base URL。

在扩展市场安装 Cline 或 Claude Code 插件。
Cline 选择 OpenAI Compatible；Claude Code 插件在环境变量或插件设置中填写对应字段。
保存配置并在插件面板发送测试请求。

CLINE · OPENAI COMPATIBLE

API Provider: OpenAI Compatible
Base URL: https://vectide.cn/v1
API Key: sk-vt-your-key
Model ID: glm-5.2

CLAUDE CODE 插件 · 环境变量

ANTHROPIC_API_KEY="sk-vt-your-key"
ANTHROPIC_BASE_URL="https://vectide.cn/v1"

TOOL 02

Claude Code 本地版

在本地终端通过环境变量指定鉴权信息与服务地址，重开终端后运行 Claude Code。

安装 Claude Code 本地命令行版本。
按操作系统写入 API Key 与 Base URL。
重开终端，运行 claude 发起测试请求。

POWERSHELL

$env:ANTHROPIC_API_KEY="sk-vt-your-key"
$env:ANTHROPIC_BASE_URL="https://vectide.cn/v1"
claude

MACOS / LINUX

export ANTHROPIC_API_KEY="sk-vt-your-key"
export ANTHROPIC_BASE_URL="https://vectide.cn/v1"
claude

TOOL 03

TRAE

在模型服务设置中添加 OpenAI 兼容提供商，直接在 IDE 内进行代码问答与 Agent 协作。

打开 TRAE 设置，进入 模型 / 自定义模型。
选择 OpenAI Compatible，填写 API Key、Base URL 和模型 ID。
保存后新建对话，发送简单消息验证连接。

TRAE · OPENAI COMPATIBLE

Provider: OpenAI Compatible
API Key: sk-vt-your-key
Base URL: https://vectide.cn/v1
Model: glm-5.2

TOOL 04

Zcode

在 Zcode 的模型设置中添加 OpenAI 兼容服务，并使用向量潮汐提供的模型 ID。

打开 Zcode 的 Settings / Model Provider。
新增 OpenAI Compatible 提供商，填写 API Key 与 Base URL。
填写模型 ID，保存后执行连接测试。

ZCODE · MODEL PROVIDER

Provider: OpenAI Compatible
Base URL: https://vectide.cn/v1
API Key: sk-vt-your-key
Model: glm-5.2

TOOL 05

OpenClaw

为 OpenClaw 添加 OpenAI 兼容提供商，字段名称以当前版本配置界面或配置文件为准。

打开 OpenClaw 的提供商配置。
选择 OpenAI Compatible，填写统一 Base URL 和 API Key。
指定模型 ID，保存并启动一次新会话验证。

OPENCLAW · PROVIDER

Provider: OpenAI Compatible
Base URL: https://vectide.cn/v1
API Key: sk-vt-your-key
Model: glm-5.2

OpenCode

v1 与 v2 的自定义提供商字段不同。请先确认客户端版本，然后按独立文档选择配置。

OpenCode v1 / v2 完整配置与排查 →

TOOL 07

CC Switch

在 CC Switch 中新增 Claude Code 服务配置，便于在多个服务入口之间切换。

打开 CC Switch，新增 Claude Code 配置。
填写 API Key 与 Base URL，并设置易识别的配置名称。
保存并切换到该配置，再启动 Claude Code 验证。

CC SWITCH · CLAUDE CODE

Configuration: Vector Tide
API Key: sk-vt-your-key
Base URL: https://vectide.cn/v1
Model: glm-5.2

Cursor

在支持自定义 Base URL 的版本中配置 Vectide 密钥与准确模型 ID。标准聊天、自备密钥与 Tab 等功能的支持范围分别核对。

Cursor 配置与功能范围 →

TOOL 09

Codex

用环境变量注入 OpenAI 兼容鉴权和 Base URL，在终端内运行 Codex。

安装并确认 Codex 可运行。
在当前终端设置 API Key 和 Base URL。
运行 codex，选择可用模型并验证响应。

POWERSHELL

$env:OPENAI_API_KEY="sk-vt-your-key"
$env:OPENAI_BASE_URL="https://vectide.cn/v1"
codex

MACOS / LINUX

export OPENAI_API_KEY="sk-vt-your-key"
export OPENAI_BASE_URL="https://vectide.cn/v1"
codex

排查顺序：若测试失败，依次确认 API Key 未带多余空格、Base URL 完整包含 /v1、模型 ID 属于当前套餐，并重新保存凭据。

常见问题

CodingPlan 周期卡的"5 小时额度"是什么意思？

5 小时额度是固定时段内的最大调用次数，每天在北京时间 00:00、05:00、10:00、15:00、20:00 刷新。额度及周限额以所购套餐为准，达到限额后需等待对应周期恢复。

周期卡和加油包可以同时使用吗？

可以。周期卡和加油包可同时持有。系统会优先消耗周期卡的调用次数额度；当周期卡额度用尽时，自动切换到消耗加油包的 Token 额度。两者互不影响，各自独立计费。

CodingPlan 通卡支持哪些模型？

国产大模型 CodingPlan 通卡支持套餐标注的全部国产模型系列，包括 GLM-5.3、deepseekv4flash0731正式版、deepseekv4pro0813正式版、MiniMax M3、Kimi K3。套餐卡片所列的 5 小时额度与周额度在支持的模型间共享，可根据任务需要随时切换。

TokenPlan 加油包会过期吗？

TokenPlan 加油包没有固定有效期，Token 额度用完为止。购买后额度立即到账，不会因时间推移而失效。建议根据实际用量选择入门包（2 亿 Token）或尊享包（10 亿 Token）。

购买后可以退款吗？

套餐一经购买并激活，不支持退款。建议首次使用先购买 TokenPlan 入门包体验平台能力，确认满足需求后再选择月卡、季卡或年卡。

API Key 在哪里获取？

注册并登录向量潮汐后，进入控制台（/dashboard），在"我的 Key"页面创建或查看 API Key。API Key 格式为 sk-...，请妥善保管，不要泄露给他人或提交到代码仓库。

平台支持多模态能力吗（如图片理解、语音输入等）？

当前暂不支持多模态功能，平台仅提供纯文本对话与代码生成能力。向量潮汐采用企业级中转通道接入上游模型服务，该通道专注于文本推理与生成链路，以确保调用的稳定性、响应速度与成本可控性。多模态能力（如图片理解、语音对话、视频分析等）需要独立的传输协议与计算资源调度，与当前中转架构暂不兼容。后续版本中若引入多模态支持，将在平台公告中同步通知。

使用过程中偶尔遇到报错或请求失败怎么办？

保留请求时间、模型 ID、请求标识与脱敏错误信息。先区分密钥或权限错误、额度耗尽、上游限流、网络超时以及流式中断，再决定等待或有限重试。升级套餐并不能保证消除所有上游错误。查看完整错误排查指南。

一站式多模型 API 聚合平台套餐 · 开发 · 工具接入全覆盖

按主题阅读新版文档