开发文档
通过 OpenAI 兼容接口,一行 Base URL 即可接入朗枢数据 · 西部词元全系模型。所有示例可直接复制运行。
快速开始
朗枢数据 · 西部词元提供与 OpenAI 完全兼容的 API。您只需把 base_url 指向朗枢数据 · 西部词元,再传入您的 API Key,即可调用平台上的全部国产开源模型。 无需安装任何额外依赖。
环境准备
export WT_BASE_URL=https://westertoken.com/v1 export WT_API_KEY=wt-xxxxxxxxxxxxxxxx
Base URL 与鉴权
Base URL 为 https://westertoken.com/v1。密钥传参支持以下三种方式(可任选其一):
- 方式一(推荐)密钥内嵌 base_url:把接口地址写成
https://westertoken.com/v1/wt-你的密钥,OpenAI SDK / 常见第三方客户端零改代码直接可用; - 方式二 自定义头:请求头加
X-Wt-Token: wt-你的密钥; - 方式三 查询参数:URL 追加
?wt_token=wt-你的密钥。
Authorization: Bearer 头传密钥:部分部署网关会替换该头导致 401。 请使用上述三种方式之一。POST https://westertoken.com/v1/chat/completions X-Wt-Token: wt-xxxxxxxxxxxxxxxx Content-Type: application/json
获取 API Key
注册账号后,进入「账户中心 → API 密钥」即可创建密钥。密钥明文仅创建时展示一次,请妥善保存。可以为每个 Key 设置消费额度上限,防止意外超支。
对话示例 / Chat Completions
from openai import OpenAI
client = OpenAI(
base_url="https://westertoken.com/v1/wt-xxxxxxxxxxxxxxxx", # 密钥内嵌在 base_url 末尾
api_key="wt-xxxxxxxxxxxxxxxx",
)
resp = client.chat.completions.create(
model="deepseek-v4.1-flash",
messages=[{"role": "user", "content": "你好,介绍一下自己"}],
)
print(resp.choices[0].message.content)流式输出 / Streaming
设置 stream=True 即可获得 SSE 流式响应,适合打字机效果与低延迟交互。
resp = client.chat.completions.create(
model="qwen3.6-flash",
messages=[{"role": "user", "content": "写一首诗"}],
stream=True,
)
for chunk in resp:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")视频生成 / Videos
视频为异步任务:先 POST 创建任务拿到 id,再轮询查询接口直到 status 变为成功,从返回的 url 取视频下载地址(生成结果保留 24 小时,请及时下载)。
curl https://westertoken.com/v1/videos/generations \
-H "X-Wt-Token: wt-xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-mini",
"prompt": "一只柯基在海边奔跑,阳光明媚,电影感",
"duration": 5
}'curl https://westertoken.com/v1/videos/{task_id} \
-H "X-Wt-Token: wt-xxxxxxxxxxxxxxxx"参数:model(模型 ID)、prompt(画面描述,必填)、duration(时长/秒,可省略按模型默认档计费)。计费按秒计算, 以各模型详情页价目为准;任务失败自动全额退款。
图像生成 / Images
curl https://westertoken.com/v1/images/generations \
-H "X-Wt-Token: wt-xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedream-5-0-flash",
"prompt": "赛博朋克风格的重庆夜景,霓虹灯雨天反射",
"n": 1
}'参数:model(模型 ID)、prompt(画面描述,必填)、n(生成张数,缺省 1)。计费按张计算,返回 url 为图片下载地址(保留 24 小时)。
语音转写 / Audio
上传音频文件,返回识别文本;按音频时长(秒)计费。
curl https://westertoken.com/v1/audio/transcriptions \ -H "X-Wt-Token: wt-xxxxxxxxxxxxxxxx" \ -F "file=@audio.mp3" \ -F "model=fun-asr" \ -F "language=zh"
计费说明
按模型类型采用对应计量单位明码标价,输入与输出分开计价。具体价格以各模型详情页为准。
- 计量标准:文本 / 多模态按
百万 tokens;视频生成、语音识别按秒;图像按张 - 文本模型计价单位:
¥ / 百万 tokens,输入价与输出价分开列示 - 输入价格:文本模型接收的 prompt 部分收费
- 输出价格:模型生成的结果(completion / 视频 / 图像 / 转写音频)按各自单位收费
- 免费模型标 免费 徽标,调用不产生费用
透明计价承诺
朗枢数据 · 西部词元的所有计费规则公开透明,并受以下承诺约束:
- 明码标价:全部模型价格在「模型广场」与各模型详情页公开列示,按各自计量单位标注单价(文本按
¥ / 百万 tokens,视频与语音识别按秒、图像按张),输入价、输出价分开列出,无任何需要注册才能查看的隐藏价格。 - 零隐性费用:不收接入费、平台月租、最低消费;除模型单价外不附加任何隐藏加价项目。
- 余额不虚扣:仅按实际成功的调用计费,请求失败、超时或被限流拦截的调用不计费。
- 账单可查:每笔调用在账户中心「费用明细」可查——调用时间、模型、token 用量与扣费金额逐条列示,可按日期区间查询、打印或导出对账。
- 免费透明:免费模型明确标注「免费」徽标,注册赠送的体验金在使用前即告知,用完不会自动扣费。
- 体验金口径:体验金以代金券形式发放(每张有面值与 180 天有效期,可在「我的钱包 → 券夹」查看), 仅限在本平台用于支付模型调用费用,不可提现、不可申请退款、不可转让; 消费时优先抵扣代金券,券不足再扣现金余额。账户注销时未使用的代金券随之失效,现金余额的未消费部分可按规定处理。
限制与配额
为保障平台稳定性与公平使用,不同模型、不同账号等级适用不同的速率限制(每分钟请求数)。 具体限额可在账户中心查看。可通过为 API Key 设置额度上限来控制消费。