快速入门

tokgate.io 是一个 AI 模型统一接入网关。你只需管理一个 API Key，但调用格式必须按模型厂家选择：Anthropic 模型使用 Anthropic Messages，Google 模型使用 Gemini 原生格式，其余大语言模型使用 OpenAI 兼容格式。图像与视频使用各自的专用接口；视频接口采用异步任务模式。

无论直接调用 API 还是使用客户端工具，都要让模型厂家、请求格式和 SDK 三者匹配；不能用同一套请求体调用所有聊天模型。

一、五分钟接入三步走

Step 1 — 获取你的 API Key

1.1 登录 tokgate.io 控制台

打开 console.tokgate.io，用邮箱 + 密码或Google 账号登录。还没有账号时点「免费注册」，注册方式由平台当前策略决定：

• 开放注册：填邮箱 → 点「获取验证码」→ 输入邮件里的 6 位验证码 → 设置密码（8–128 位）。
• 邀请注册：需要填写邀请码（最长 16 位），可向商务或已注册同事索取。
• 注册需勾选同意服务条款与隐私政策。

1.2 创建 API 密钥

登录后在左侧导航点「密钥与资源 › API 密钥」，右上角点「创建密钥」，弹窗里可配置：

1.3 保存你的 API Key

提交后会弹出「密钥创建成功」，明文密钥以 sk- 开头，点旁边的复制按钮取走。

Step 2 — 调用第一个 API

先根据模型厂家选择协议。本节用 DeepSeek 模型演示 OpenAI 兼容格式；Anthropic 与 Google 模型请分别使用 Anthropic Messages 与 Gemini 原生格式，不能直接套用下面的请求体。

2.1 查看可用模型

可在模型广场浏览全部模型，也可在控制台「模型 › 模型广场」页按厂商筛选、查看上下文长度与 Credits 单价、一键复制模型 ID。若要在代码里动态获取，直接调 models 接口：

curl https://api.tokgate.io/v1/models \
  -H "Authorization: Bearer sk-***"

返回结果中的 id 字段即为调用时要填的模型名称。

2.2 发出第一个请求

curl https://api.tokgate.io/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-***" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [
      {"role": "system", "content": "你是一个乐于助人的助手"},
      {"role": "user", "content": "你好，介绍一下你自己"}
    ]
  }'

from openai import OpenAI

client = OpenAI(
    api_key="sk-***",
    base_url="https://api.tokgate.io/v1",
)

response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[{"role": "user", "content": "你好，介绍一下你自己"}],
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.TOKGATE_API_KEY,
  baseURL: "https://api.tokgate.io/v1",
});

const response = await client.chat.completions.create({
  model: "deepseek-v4-pro",
  messages: [{ role: "user", content: "你好，介绍一下你自己" }],
});
console.log(response.choices[0].message.content);

package main

import (
    "context"
    "fmt"
    openai "github.com/sashabaranov/go-openai"
)

func main() {
    cfg := openai.DefaultConfig("sk-***")
    cfg.BaseURL = "https://api.tokgate.io/v1"
    client := openai.NewClientWithConfig(cfg)

    resp, err := client.CreateChatCompletion(context.Background(),
        openai.ChatCompletionRequest{
            Model: "deepseek-v4-pro",
            Messages: []openai.ChatCompletionMessage{
                {Role: "user", Content: "你好，介绍一下你自己"},
            },
        })
    if err != nil {
        panic(err)
    }
    fmt.Println(resp.Choices[0].Message.Content)
}

Step 3 — 接入你的工具

客户端或 SDK 必须支持目标模型对应的协议。三类协议共用同一把 API Key，但 Base URL、请求路径和请求体不同：

Claude Code / Codex CLI

命令行代码助手，设置环境变量即可。Claude Code 走 Anthropic 协议，Codex CLI 走 OpenAI 协议。

# Claude Code（Anthropic 协议）
export ANTHROPIC_BASE_URL="https://api.tokgate.io"
export ANTHROPIC_AUTH_TOKEN="sk-***"

# Codex CLI（OpenAI 协议）
export OPENAI_BASE_URL="https://api.tokgate.io/v1"
export OPENAI_API_KEY="sk-***"

Cherry Studio 等桌面客户端

1. 打开「设置 › 模型服务商 › 添加服务商」。
2. 服务商类型必须与模型厂家匹配：Anthropic 模型选 Anthropic，Google 模型选 Gemini，其余大语言模型选 OpenAI 兼容。
3. 按上表填写对应 Base URL，并使用控制台创建的同一把 API Key。
4. 添加要使用的模型 ID（可从 GET /v1/models 或模型广场获取）。

其他客户端与 SDK

LangChain、LlamaIndex、Vercel AI SDK、Dify、FastGPT、NextChat、LobeChat 等工具能否接入，取决于它是否支持目标模型对应的协议和自定义 Base URL。分别使用 OpenAI、Anthropic 或 Google Gen AI SDK；不要用 OpenAI 请求格式调用 Anthropic 或 Google 模型。

二、账户与计费

平台统一使用 Credits 计费。选择固定美元金额充值，按 1 USD = 200 Credits 到账，调用时按模型公开单价扣减：

• 充值 Credits：进入控制台「计费中心 › Credits 与订单」，选择页面展示的固定美元金额完成支付，按 1 USD = 200 Credits 到账。
• 无赠送比例：Credits 只按固定汇率换算，不因充值档位增加赠送额度。
• 流水与订单：Credits 流水记录充值、调用扣减、手续费、预扣、结算与释放；订单页可查订单号、金额、平台费、渠道与支付状态。
• 单价口径：模型广场按「Credits / 每百万 tokens」标注输入、输出、缓存读、缓存写四项单价，不同模型不同，实际扣减以控制台明细为准。

用量与报表

控制台「计费中心 › 用量与报表」可以看到：

• 汇总卡：总请求、总 Tokens、总 Credits 消耗与当前 Credits 余额。
• 报表（时间口径 UTC）：默认近 30 天，可按日期 / 模型 / 密钥三个维度切换。按日期出趋势图，按模型或密钥出可排序表格。
• 调用明细（时间口径为本地时间）：时间、模型、密钥前缀、输入 Token、输出 Token、Credits 消耗、延迟（ms）、成功 / 失败状态，支持按时间范围与模型筛选。
• 导出 CSV：一键导出当前筛选条件下的用量数据，用于自建对账。

三、控制台功能地图

四、API 能力一览

完整参数、响应结构与错误码见 API 文档。

五、常见问题

怎么知道自己有哪些可用模型？

三种方式：调 GET /v1/models（返回的是当前密钥实际可用的模型）；在控制台「模型广场」浏览并复制模型 ID；在官网模型广场查看。若创建密钥时设了模型白名单，白名单之外的模型不会出现在该密钥的可用列表里。

返回 401 Unauthorized 怎么排查？

• 鉴权头是否与协议匹配：OpenAI 与 Gemini 使用 Authorization: Bearer ...，Anthropic 使用 x-api-key。
• 密钥是否被复制完整（明文只展示一次，截断的密钥会一直报 401）。
• 密钥是否已被删除、停用或超过有效期。
• 是否把控制台登录态当成了 API 鉴权 —— 调用模型接口只认 API Key，不认登录 Cookie。

返回 403 Forbidden 怎么排查？

通常是权限范围问题：密钥设了模型白名单而请求的模型不在其中；或该模型未对当前账户开放。到控制台「API 密钥」页编辑白名单，或换用不限模型的密钥。

返回 402 / 提示额度不足？

说明 Credits 余额不足，或这把密钥的消费配额上限已用尽。前者到「Credits 与订单」充值 Credits，后者编辑密钥调高配额上限。密钥配额用尽只影响该密钥，不影响账户其它密钥。

返回 429 Too Many Requests？

触发了密钥的 RPM 速率限制或上游并发上限。建议客户端做指数退避重试（如 1s、2s、4s，设置最大重试次数），并按需调高密钥 RPM。持续高并发需求可联系商务评估。

提示「密钥无效或与当前网关环境不匹配」？

密钥与网关环境是绑定的。生产环境统一使用 api.tokgate.io；协议根路径分别为 OpenAI /v1、Anthropic SDK 根地址（不带 /v1）和 Gemini /v1beta。

长时间生成怎么设置超时？

图像生成耗时明显长于对话。对话建议开启流式（stream: true）改善首字延迟；图像同步返回，客户端超时不要设得太短。视频接口采用异步任务，提交后保存任务 ID 并轮询状态，不要用长连接等待。具体见 图像 与 视频 文档。

完整参数说明去哪里看？

API 文档 提供逐字段的请求 / 响应说明与可运行示例，分为聊天、图像、视频三部分。仍有疑问可通过联系页找到我们。