概述

快速入門

TokSpan 與 OpenAI 相容——只需更改基礎地址即可立即存取 200+ 模型。同時支援 Claude Code / Anthropic 原生、Gemini 與 OpenAI Responses API，詳見下方。

1

註冊並登入

以 Email 在註冊頁面建立帳戶。

2

建立 API Key

在儀表板的 API Keys 頁面上生成 sk- 金鑰。

3

替換 Base URL

將 SDK 的基礎地址指向下方任一基礎地址，並使用您的金鑰呼叫。

4

更新／新增 Model ID

前往 Model Plaza 取得 Model ID，然後更新。

API 基礎地址

TokSpan 支援多種 API 協定。選擇您的 SDK 已在使用的格式 — 所有格式都接受相同的 API Key，並可存取全部 200+ 模型。

OpenAI 相容
https://api.tokspan.com/v1

OpenAI SDK 已含 /v1，會自動拼接 /chat/completions。

Anthropic 原生
https://api.tokspan.com

使用主機根路徑——Claude Code / Anthropic SDK 會自動拼接 /v1/messages。

Gemini 相容
https://api.tokspan.com/v1beta

Google SDK 走原生 v1beta 協定（generateContent）。

Responses API
https://api.tokspan.com/v1

複用 OpenAI 相容基礎地址，呼叫 /v1/responses。

OpenAI 相容

python
from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.tokspan.com/v1",  # ← OpenAI-compatible base URL
)

response = client.chat.completions.create(
    model="MODEL_NAME",  # Replace MODEL_NAME with any model from the catalog
    messages=[{"role": "user", "content": "Hello!"}],
)

print(response.choices[0].message.content)

Anthropic 原生

python
from anthropic import Anthropic

client = Anthropic(
    api_key="sk-your-api-key",
    base_url="https://api.tokspan.com",  # ← Native Anthropic base URL (host root; SDK appends /v1/messages)
)

response = client.messages.create(
    model="MODEL_NAME",  # Replace MODEL_NAME with any Claude model from the catalog
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)

print(response.content[0].text)

Gemini 相容

python
from google import genai

client = genai.Client(
    api_key="sk-your-api-key",
    http_options=genai.types.HttpOptions(
        base_url="https://api.tokspan.com/v1beta",  # ← Gemini base URL
    ),
)

response = client.models.generate_content(
    model="MODEL_NAME",  # Replace MODEL_NAME with any Gemini model from the catalog
    contents="Hello!",
)

print(response.text)

Responses API

python
from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.tokspan.com/v1",  # ← Same base URL as OpenAI-compatible
)

response = client.responses.create(
    model="MODEL_NAME",  # Replace MODEL_NAME with any model from the catalog
    input="Hello!",
)

print(response.output_text)
一個金鑰，適用所有格式。四種格式都使用相同的 TokSpan API Key。餘額與用量共用 — 只需呼叫想要的模型名稱。

使用 TokSpan API

無需 SDK——直接以 HTTP 向 OpenAI 相容端點發送請求：

所有請求使用相同格式：POST https://api.tokspan.com/v1/chat/completions，並在 Authorization 標頭中附上您的 API 金鑰。

python
import requests

def chat(prompt: str, model: str = "MODEL_NAME"):  # Replace MODEL_NAME with any model from the catalog
    response = requests.post(
        "https://api.tokspan.com/v1/chat/completions",
        headers={
            "Authorization": "Bearer sk-your-api-key",
            "Content-Type": "application/json",
        },
        json={
            "model": model,
            "messages": [{"role": "user", "content": prompt}],
        },
    )
    return response.json()["choices"][0]["message"]["content"]

print(chat("Hello! What models are available?"))
typescript
const chat = async (prompt: string, model = 'MODEL_NAME') => {  // Replace MODEL_NAME with any model from the catalog
  const res = await fetch('https://api.tokspan.com/v1/chat/completions', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer sk-your-api-key',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      model,
      messages: [{ role: 'user', content: prompt }],
    }),
  });
  const data = await res.json();
  return data.choices[0].message.content;
};
shell
curl -X POST "https://api.tokspan.com/v1/chat/completions" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

跨格式轉換

TokSpan 在背景自動轉換不同的 API 格式。您始終以OpenAI Chat Completions 格式發送請求 — TokSpan 處理到上游供應商原生格式的轉換：

  • OpenAI → Claude Messages API — 系統提示詞、多輪對話及工具定義自動重新映射
  • OpenAI → Gemini API — 內容部件、安全設定及生成配置透明轉換
  • Claude → OpenAI 格式 — Claude 的原生回應被正規化為標準 Chat Completions 回應結構

這意味著您可以使用 OpenAI Python/Node SDK、LangChain 或任何 OpenAI 相容的函式庫來呼叫任何模型 — 無論其原生 API 格式為何。

金鑰範圍限制與權限

每個 API 金鑰可設定特定權限範圍：

  • 模型：限制金鑰可存取的模型
  • 消費上限：設定硬性額度限制 — 額度用盡時金鑰會自動停用
  • IP 白名單：僅允許來自特定 IP 範圍的請求
安全性提醒：絕不在用戶端程式碼中暴露您的 API 金鑰。請使用環境變數或安全的後端代理。所有發送至 TokSpan 的請求均以 TLS 1.3 加密。

接下來做什麼？