文档目录

API 参考

v1· 更新于 2026年7月

160+ 个模型 · 12 个模型系列

WayJet 是一个兼容 OpenAI 的网关。把任意 OpenAI SDK 指向下方的基础 URL,使用 sk- 开头的 API 密钥,即可通过一个统一的 API 调用所有服务商。

12 个模型系列

OpenAI、Anthropic、Gemini、Groq 等,统一在一个 API 之后。

兼容 OpenAI

把任意 OpenAI SDK 指向基础 URL 即可,无需改代码。

流式输出

对话补全开箱即支持逐 token 的 SSE 流式输出。

密钥与预算

可限定范围的密钥、按周期的消费上限,以及用量统计。

用你的密钥调用 GET /v1/models,即可列出网关为你提供的模型。

简介#

所有请求都发往同一个基础 URL。由于网关使用 OpenAI 的接口格式,现有的 SDK 和工具无需改动——只需替换基础 URL 和密钥。

https://api.wayjet.ai/v1

身份验证#

在 Authorization 请求头中使用 Bearer 令牌进行身份验证。在 API 密钥 页面创建以 sk- 开头的密钥——密钥只显示一次,请妥善保存。

header
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx
切勿在客户端代码中暴露密钥。请从你的服务器调用网关,或通过代理转发。
创建 API 密钥

快速开始#

发送你的第一个对话补全请求。把 WAYJET_API_KEY 设为你的 API 密钥后直接运行,或把 gpt-5.1 换成 GET /v1/models 返回的任意模型 ID——该接口会列出你的密钥可调用的模型。

curl https://api.wayjet.ai/v1/chat/completions \
  -H "Authorization: Bearer $WAYJET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.1",
    "messages": [{"role": "user", "content": "Hello"}]
  }'
在 Playground 中试用

对话补全#

POST /v1/chat/completions——核心接口。请求和响应遵循 OpenAI 的格式;网关会在响应中额外加入 provider 和 cache_status。

参数类型说明
model*stringGET /v1/models 返回的模型 ID(示例中为 gpt-5.1)
messages*array对话消息(role + content)
streamboolean以服务器推送事件(SSE)流式返回 token
temperaturenumber采样温度,0–2(默认 1)
max_tokensinteger最多生成的 token 数
top_pnumber核采样的概率质量
toolsarray模型可调用的函数/工具定义
tool_choicestring | object强制或限制工具的选择
response_formatobject例如 { "type": "json_object" } 开启 JSON 模式
reasoning_effortstringlow · medium · high(推理模型)
stopstring | array最多 4 个停止序列
seedinteger尽量保证结果可复现的采样种子
providerstring网关专用——把请求固定到某一个服务商

* 必填

流式输出#

设置 stream: true 即可以服务器推送事件的形式接收 token。每个事件是一行带增量内容的 data:,流以 data: [DONE] 结束。

curl https://api.wayjet.ai/v1/chat/completions \
  -H "Authorization: Bearer $WAYJET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.1",
    "messages": [{"role": "user", "content": "Hello"}],
    "stream": true
  }'
# → server-sent events: lines of  data: {...}  terminated by  data: [DONE]

提示缓存#

一些上游服务商会缓存最近见过的提示前缀,再次处理时收费更低。在 OpenAI、Gemini 和 DeepSeek 上,这会自动发生:不需要你传任何参数,你和 WayJet 都无法关闭它。Anthropic 只在请求明确要求时才缓存。

使用平台密钥时,WayJet 只对绑定到自有 Anthropic 工作区的账号保留 `cache_control`。 否则该标记会被接收,但在请求到达 Anthropic 之前被移除。调用仍会成功,但它的 usage 中没有缓存 token,所有输入 token 都按完整输入单价计费——这也正是 Anthropic 对它的收费。使用你自己的 Anthropic 密钥时,该标记始终会传递过去。

每个厂商都以它自己的客户为单位划定缓存边界。使用 WayJet 平台密钥时,这个客户就是 WayJet——因此在三家自动缓存的服务商上,你的请求会在下表的复用时长内,与其他 WayJet 账号共享同一个缓存空间。网关会在对话补全的响应中返回 cache_status,但它只说明前缀是否被复用,而不说明是谁的。

服务商缓存方式缓存边界复用时长
OpenAI自动组织——使用平台密钥时为 WayJet 的组织最长 30 分钟
Gemini自动Google Cloud 项目——使用平台密钥时为 WayJet 的项目最长 24 小时
DeepSeek自动账号——使用平台密钥时为 WayJet 的账号数小时到数天
Anthropic按请求(cache_control),需使用你自己的密钥或绑定的账号你自己的账号(BYOK)或你绑定的工作区5 分钟
Bedrock / Vertex 上的 Claude按请求,仅限自有凭证AWS 账号 / GCP 项目5 分钟

共享缓存意味着什么,又不意味着什么

提示缓存不会让任何提示或回复内容流向他人。缓存命中只是厂商以更低的成本重新处理调用方自己已发送过的前缀——不会把任何人的文字交给其他人。共享缓存空间暴露的是时间信息:一个已经掌握某段完全相同前缀的人,理论上可能从更快或更便宜的响应中推断出这段前缀最近被发送过。前提是他必须先知道这段前缀,这也限定了风险的范围。

我们公开这些,是因为你自己无法观察到。WayJet 有意隐藏是哪个上游处理了请求,因此 API 和控制台中都不会告诉你厂商的缓存边界在哪里。如果你把推理能力转售给自己的用户,这里就是同一个问题在下一层的答案。

如果你需要独立的缓存空间

只有两条路,也是仅有的诚实做法——平台密钥上没有任何按租户的设置能做到这一点:

  • 使用你自己的密钥。 添加你自己的服务商凭证后,你的流量会以你在厂商处的账号运行,缓存边界也会划在你身上。这适用于所有服务商,是完整的解决方案。
  • 申请 Anthropic 工作区。 仅针对 Anthropic,我们可以把你的账号绑定到它自己的 Anthropic 工作区,让你在继续使用平台密钥的同时,独享自己的提示缓存。这需要申请、按账号开启——没有自助开关,也不适用于通过 Bedrock 或 Vertex 调用的 Claude,因为它们没有对应的机制。这同时也是平台密钥账号开启 Anthropic 缓存的唯一方式。

向量嵌入#

POST /v1/embeddings——把文本向量化,用于搜索和 RAG。可传入一个字符串或字符串数组。

curl https://api.wayjet.ai/v1/embeddings \
  -H "Authorization: Bearer $WAYJET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-embedding-model",
    "input": "The quick brown fox"
  }'

音频(语音)#

POST /v1/audio/speech 把文本转成语音(按输入字符计费),POST /v1/audio/transcriptions 把上传的音频文件转成文字(按音频分钟计费)。两者都兼容 OpenAI。

文字转语音

curl https://api.wayjet.ai/v1/audio/speech \
  -H "Authorization: Bearer $WAYJET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-tts-model",
    "input": "The quick brown fox jumped over the lazy dog.",
    "voice": "alloy"
  }' \
  --output speech.mp3

语音转文字

以 multipart/form-data 上传文件。把 response_format 设为 srt、vtt 或 verbose_json,即可得到带时间戳的字幕,而不是纯文本。

curl https://api.wayjet.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $WAYJET_API_KEY" \
  -F "model=your-stt-model" \
  -F "file=@audio.mp3" \
  -F "response_format=json"   # json (default) · text · srt · vtt · verbose_json

模型#

GET /v1/models 返回你的密钥可用的模型目录,每个模型都附带价格和能力信息。用列表中的 id 作为本页所有示例中的 model。

shell
curl https://api.wayjet.ai/v1/models \
  -H "Authorization: Bearer $WAYJET_API_KEY"
浏览全部模型

命令行工具(Claude Code、Codex)#

网关支持 Anthropic Messages API(POST /v1/messages)和 OpenAI Responses API(POST /v1/responses),因此主流编程 CLI 可以直接接入 WayJet,并通过你自己的密钥计费——无需代理,也无需各厂商的 SDK。把每个工具指向你可以调用的模型即可。

什么是 squad?

squad 就是你调用的模型名称:网关上一个有名字的产品,以自己的名字响应请求。凡是需要填模型名称的地方,都可以使用 squad 名称。GET /v1/models 会列出你的密钥可调用的 squad。下方配置中的模型名称都是 squad,复制即可使用。

Claude Code

添加到 ~/.claude/settings.json。密钥通过 ANTHROPIC_AUTH_TOKEN 传递(或以 ANTHROPIC_API_KEY 作为 x-api-key 请求头),每个档位都可以映射到你选择的模型。

~/.claude/settings.json
{
  "hasCompletedOnboarding": true,
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.wayjet.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"
  }
}

Codex

Codex 默认使用 OpenAI Responses API——无需设置 wire_api = "chat"。

~/.codex/config.toml
model = "gpt-5.1"
model_provider = "wayjet"

[model_providers.wayjet]
name = "WayJet"
base_url = "https://api.wayjet.ai/v1"
wire_api = "responses"
~/.codex/auth.json
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk-your-key"
}

Claude Code 和 Codex 会把每个请求发送到它们指定的那一个模型。

错误#

错误使用标准的 HTTP 状态码,以及 OpenAI 风格的错误结构。

json
{
  "error": {
    "message": "Incorrect API key provided.",
    "type": "authentication_error",
    "code": null,
    "param": null
  }
}
状态码类型含义
200OK请求成功
400invalid_request_error请求格式错误或参数无效
401authentication_errorAPI 密钥缺失、无效或已被吊销
403permission_error该密钥无权执行此操作
404not_found_error未知的模型或资源
429rate_limit_error触发了速率限制,或超出了预算
500api_error网关发生意外错误
查看你的用量和速率限制

接口列表#

可以用 API 密钥调用的接口。密钥、用量和预算在控制台中管理。

方法接口说明
POST/v1/chat/completions对话补全(流式与非流式)
POST/v1/messagesAnthropic Messages 格式(流式与非流式;x-api-key 或 Bearer)
POST/v1/responsesOpenAI Responses 格式(流式与非流式)。无状态:会忽略 previous_response_id,因此每次都要发送完整对话
GET/v1/generation单个请求的费用与 token 用量,按其 X-Wayjet-Request-Id 查询(?id=)
POST/v1/embeddings创建向量嵌入
POST/v1/audio/speech文字转语音(输出音频)
POST/v1/audio/transcriptions语音转文字(转写)
GET/v1/models列出可用模型

更新日志#

公开 API 的重要变更。为保持向后兼容,基础 URL 始终为 /v1。

  • 2026年7月命令行工具:可直接使用 Claude Code(/v1/messages)和 Codex(/v1/responses)。生成统计(/v1/generation)。
  • 2026年7月音频:文字转语音(/v1/audio/speech)和语音转文字(/v1/audio/transcriptions,支持 srt/vtt/verbose_json 格式)。
  • 2026年6月新增 reasoning_effort。
  • 2026年5月向量嵌入接口,以及 JSON 模式(response_format)支持。
  • 2026年4月对话补全支持流式输出(SSE);可指定服务商。
完整更新日志