完整指南｜向量潮汐

平台能力

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

🔀

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

🔑

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

🧩

OpenAI 兼容完全兼容 OpenAI 接口协议，现有应用只需替换 Base URL 与 Key 即可无缝迁移。

🛠️

工具即插即用VS Code、Cursor、TRAE、Claude Code 等 9+ 主流工具均已验证配置方案。

📊

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

⚡

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

支持的模型

平台已上架多个系列模型，覆盖文本生成、代码推理、语音合成等场景。以下为主要模型系列，实际可用模型 ID 以控制台"套餐详情"显示为准。

模型系列	模型 ID	Token 倍率	上下文	适用场景
智谱 GLM	glm-5.2	3x	500K	复杂推理、编码、工具调用
智谱 GLM	glm-5.1	1x	200K	通用对话、编码、高并发
智谱 GLM	glm-5	1x	200K	日常对话、批量任务
DeepSeek	deepseek-v4-pro	2x	1M	深度推理、数学与代码
DeepSeek	deepseek-v4-flash	1x	1M	快速响应、高并发任务
Kimi	kimi-k3	4x	500K	复杂推理、代码与长文本
MiniMax	MiniMax-M3	2x	1M	智能体、长文与角色对话
MiniMax	MiniMax-M2.7	1x	200K	通用对话与轻量任务
GPT	gpt-5.6-sol	6x	500K	复杂推理、代码与工具调用
GPT	gpt-5.6-luna	2x	500K	通用对话与高频任务
GPT	gpt-5.6-terra	4x	500K	综合推理与内容生成
GROK	grok-4.6	6x	500K	复杂推理与长上下文任务
GROK	grok-4.5	4x	500K	通用推理与内容生成
Claude	claude-fable-5	10x	500K	深度推理、长文档与编码
Claude	claude-opus-4.8	6x	500K	复杂推理、长文档与编码

提示：模型列表持续更新。登录控制台后，可在套餐详情中查看当前账号可调用的完整模型清单与实时价格。

套餐总览

向量潮汐提供两种使用模式：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 小时窗口上限或周限额后，需要等待对应额度周期恢复。

正在加载当前套餐…

额度规则：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 天	用完为止，无过期
模型范围	绑定单个模型系列（通用卡除外）	全系列通用
额度恢复	北京时间固定时段刷新	消耗后不恢复
适合场景	固定模型、稳定频率使用	多模型混用、用量波动大
能否叠加	可同时持有多个周期卡	可与周期卡叠加使用
起售价格	¥59.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.2",
    "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.2",
    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.2",
  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 是模型处理文本的基本单位，约 1 个中文词或 1 个英文单词计为 1 个 Token。每次请求消耗的 Token 数会计入用量，可在控制台"用量趋势"与"消费日志"中实时查看。

工具接入教程

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

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

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

03 · 模型 ID按已购套餐选择可用模型，如 glm-5.2、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

TOOL 06

OpenCode

通过 OpenAI 兼容提供商配置 OpenCode，在终端内使用统一模型入口。

打开 OpenCode 配置文件或提供商设置。
设置 API Key、Base URL 与模型 ID。
重启 OpenCode，选择该模型并测试响应。

OPENCODE · PROVIDER

provider: openai-compatible
baseURL: https://vectide.cn/v1
apiKey: sk-vt-your-key
model: glm-5.2

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

TOOL 08

Cursor

使用 OpenAI API Key 与 Override OpenAI Base URL，将自定义模型请求指向向量潮汐。

打开 Settings → Models。
填写 OpenAI API Key，开启 Override OpenAI Base URL。
填入统一地址并添加模型 ID，保存后测试。

CURSOR · MODELS

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

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-...，请妥善保管，不要泄露给他人或提交到代码仓库。

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

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

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

在业务高峰时段（通常为工作日 10:00–12:00、14:00–18:00），由于上游模型算力资源紧张，部分请求可能出现超时、429 限流或 500 服务端错误。这种情况通常是暂时的，以下方法可以快速恢复：
1）切换模型：尝试同系列的其他模型（如 glm-5.2 → glm-5.1，或切换至 DeepSeek V4），不同模型的算力池相互独立；
2）稍后重试：等待 1-2 分钟后重新发起请求，多数情况下可自动恢复；
3）升级套餐：如频繁触发限流，可升级至优享版套餐，优享版采用算力优先通道，保障高峰期也有充足的算力。