API 端点

Tokener.ai 模型 API 的 base URL 与支持的 OpenAI 和 Anthropic 兼容路径。

更新于 2026-11-02
在 GitHub 编辑

支持的模型 API 表面(相对下方 base URL):

状态方法路径用途
支持GET/models列出你的密钥可用且允许展示的模型 id
支持GET/models?client_version=…Codex 远端模型选择器
支持GET/models/userClaude Code 网关模型选择器
支持POST/chat/completions对话与推理模型(主路径)
支持POST/embeddings嵌入模型
支持POST/rerank使用已授权模型按查询为文档排序
支持POST/audio/transcriptions转写以 multipart 表单上传的音频文件
支持POST/audio/speech生成语音并以二进制音频流返回
支持POST/messagesAnthropic Messages API 形态,含 Claude Code 等 Agent 客户端
支持POST/messages/count_tokens统计 Anthropic Messages 请求的输入 token,不生成消息
支持POST/responsesOpenAI Responses API,含 Codex 等 Agent 客户端

对话类路径支持流式(stream: true)。有哪些模型、价格与可用性以线上 模型 目录为准,文档不复制清单。

判定模型不兼容 OpenAI 与 Anthropic,不在 /v1 下提供,见 判定 API。

Rerank 请求使用 model、query 和 documents,可选 top_n 和 return_documents。响应的 results 包含文档索引与相关性分数。请使用明确分配的模型 ID;隐藏模型即使已授权,也不会出现在 /models 中。Rerank 不支持流式响应。

转写请求使用 multipart/form-data,包含 model 和 file 字段。语音生成请求使用 JSON,包含 model、input 和 voice。语音生成成功后以音频字节流返回,并保留 Content-Type。两条音频路径均使用你的 Tokener.ai API 密钥。模型自身的格式和限制仍然适用。

Token 计数请求采用 Anthropic 格式,包含 model、messages,以及 system、 tools 等受支持字段。JSON 响应包含 input_tokens,不代表最终扣费结算。 该路径不支持流式响应,使用与 /messages 相同的 Tokener.ai API 密钥和 Anthropic 请求头。是否可用取决于所选模型及密钥权限。

Base URL

https://api-staging.tokener.dev/v1

上方兼容路径使用此 base URL。它提供兼容 OpenAI 的端点和兼容 Anthropic 的 /messages 端点。网站与控制台不代理 LLM 调用。Tokener.ai API 密钥使用 Bearer token,/messages 也可使用 x-api-key。

TypeScript
import OpenAI from "openai";
 
const client = new OpenAI({
  apiKey: process.env.TOKENER_API_KEY,
  baseURL: "https://api.tokener.ai/v1",
});

调用前请先在 API 密钥 中创建密钥。

Gemini 原生路径

同一 API 域名下,不加 /v1 前缀,可调用:

  • POST /v1beta/models/{model}:generateContent
  • POST /v1beta/models/{model}:streamGenerateContent?alt=sse
  • POST /v1beta/models/{model}:countTokens
  • POST /v1beta/models/{model}:embedContent
  • POST /v1beta/models/{model}:batchEmbedContents
  • POST /v1beta/interactions

请使用公开模型 ID,通过 Bearer 或 x-goog-api-key 发送 Tokener.ai 密钥, 不要发送 Google 上游密钥。不接受 query 密钥、上游或部署覆盖字段。 Interactions 必须明确指定模型,不支持 agent 或 previous interaction ID。 仍需原生 provider 配置和密钥授权;兼容 API 可调用不代表原生参数已等价支持。 原生 embedding 不支持流式输出,仅支持 gemini-embedding-001 文本和 gemini-embedding-2-preview 文本/PNG/JPEG,每个请求最多100项、6张图片。 仍须原生配置、普通密钥授权,并仅按输入计算预算。 这些模型路径不提供资源管理接口。错误采用 Google 协议格式。

生成响应中的 continuationToken 是不透明值。请保持原值,使用相同的 org/密钥、 模型、生成操作和请求配置继续调用。不能替换为 Google 或其他端点的 token, 也不能因请求结果未知而自行重试该请求。

Gemini Files 资源

启用 Files 能力后,同一 API 域名提供以下有限路径:

Text
POST   /upload/v1beta/files
POST   /upload/v1beta/files/{session-UUID}
GET    /v1beta/files/{owned-token}
DELETE /v1beta/files/{owned-token}

每次请求,包括二进制分片,都必须携带 Tokener.ai org 密钥。 只使用此 API 返回的上传 URL 和不透明 File 名称/URI,资源仍绑定原 org 和密钥。 START 使用 snake_case 文件元数据;分片保留 SDK 的上传协议、总大小和 MIME 请求头。 必须提供已知 Content-Length 并使用 identity 编码;START 上限32KiB,单分片上限8MiB。 不要在 query 中放置密钥或上游 URL。

最终上传响应包含 file 包装;GET 直接返回文件元数据及真实处理状态。 归属文件已失效或过期时返回410;其他错误不能作为重新上传或重试未决模型调用的依据。 不提供文件列表、下载、注册或 cached-content API,也不支持 CountTokens 文件引用。

Agent 客户端

编码 Agent 可直接使用这些路径。参见 Codex (/responses)与 Claude Code(/messages) 的接入指南。

每个响应——无论成功或出错——都带有 x-request-id 与 request-id 响应头; 联系支持时请附上该值。不支持浏览器 CORS:请从你的后端调用这些路径,不要 直接从浏览器调用。错误响应格式与完整错误码表见 错误。