API 端点
Tokener.ai 模型 API 的 base URL 与支持的 OpenAI 和 Anthropic 兼容路径。
支持的模型 API 表面(相对下方 base URL):
| 状态 | 方法 | 路径 | 用途 |
|---|---|---|---|
| 支持 | GET | /models | 列出你的密钥可用且允许展示的模型 id |
| 支持 | GET | /models?client_version=… | Codex 远端模型选择器 |
| 支持 | GET | /models/user | Claude Code 网关模型选择器 |
| 支持 | POST | /chat/completions | 对话与推理模型(主路径) |
| 支持 | POST | /embeddings | 嵌入模型 |
| 支持 | POST | /rerank | 使用已授权模型按查询为文档排序 |
| 支持 | POST | /audio/transcriptions | 转写以 multipart 表单上传的音频文件 |
| 支持 | POST | /audio/speech | 生成语音并以二进制音频流返回 |
| 支持 | POST | /messages | Anthropic Messages API 形态,含 Claude Code 等 Agent 客户端 |
| 支持 | POST | /messages/count_tokens | 统计 Anthropic Messages 请求的输入 token,不生成消息 |
| 支持 | POST | /responses | OpenAI 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。
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}:generateContentPOST /v1beta/models/{model}:streamGenerateContent?alt=ssePOST /v1beta/models/{model}:countTokensPOST /v1beta/models/{model}:embedContentPOST /v1beta/models/{model}:batchEmbedContentsPOST /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 域名提供以下有限路径:
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:请从你的后端调用这些路径,不要
直接从浏览器调用。错误响应格式与完整错误码表见 错误。