TokenSG Docs

中文

English

中文

English

Appearance

快速开始 ​

5 步上手 TokenSG，5 分钟内发送第一个 API 请求。

第 1 步：注册账号 ​

前往 TokenSG 控制台 注册账号，注册即赠送免费额度。

第 2 步：获取 API Key ​

  1. 登录 控制台
  2. 进入 API Keys 页面
  3. 点击 创建新 Key
  4. 复制并妥善保存 — 密钥仅显示一次

第 3 步：接口地址 / API Endpoints ​

TokenSG 用同一个账号、同一批 API Key、同一套计费，同时暴露两套协议兼容的接口地址。按你正在用的 SDK 挑对应的那一套即可：

协议Base URL端点认证头
OpenAI 兼容https://api.tokensg.ai/v1（带 /v1）POST /v1/chat/completions
POST /v1/responses
GET /v1/models		Authorization: Bearer <KEY>
Anthropic 兼容https://api.tokensg.ai（不带 /v1）POST /v1/messagesx-api-key: <KEY>

为什么两者的 /v1 不一样？

这不是笔误，是故意的。OpenAI SDK 会自己拼接 /chat/completions，而 Anthropic SDK 会自己拼接 /v1/messages——所以两者的 base_url / baseURL 正好差一层路径。照上表原样填写即可，剩下的路径交给 SDK 自己拼。

（网关实际上在两套接口上都接受三种认证头：Authorization: Bearer、x-api-key、api-key。上表只是分别对齐各 SDK 自己的默认写法，让你可以直接复制粘贴，不用额外配置。）

第 4 步：发送第一个请求（OpenAI 兼容） ​

TokenSG 完全兼容 OpenAI API，只需将 base_url 改为 https://api.tokensg.ai/v1。

python
from openai import OpenAI

client = OpenAI(
    api_key="sk-your-tokensg-key",
    base_url="https://api.tokensg.ai/v1",
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "你好！"}],
)
print(response.choices[0].message.content)
javascript
import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: 'sk-your-tokensg-key',
  baseURL: 'https://api.tokensg.ai/v1',
})

const response = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: '你好！' }],
})
console.log(response.choices[0].message.content)
go
package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	body := map[string]interface{}{
		"model": "gpt-4o",
		"messages": []map[string]string{
			{"role": "user", "content": "你好！"},
		},
	}
	jsonBody, _ := json.Marshal(body)

	req, _ := http.NewRequest("POST",
		"https://api.tokensg.ai/v1/chat/completions",
		bytes.NewBuffer(jsonBody))
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("Authorization", "Bearer sk-your-tokensg-key")

	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
	data, _ := io.ReadAll(resp.Body)
	fmt.Println(string(data))
}
bash
curl https://api.tokensg.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-tokensg-key" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好！"}]
  }'

从 OpenAI 迁移？

如果你已在使用 OpenAI SDK，只需将 base_url / baseURL 改为 https://api.tokensg.ai/v1，无需其他代码改动！

第 5 步：发送第一个请求（Anthropic 兼容） ​

更习惯 Claude 风格的 API？TokenSG 原生支持 Anthropic Messages API。将官方 anthropic SDK（或直接发 HTTP 请求）指向 https://api.tokensg.ai（不带 /v1），并用 x-api-key 认证即可。

python
import anthropic

client = anthropic.Anthropic(
    api_key="sk-your-tokensg-key",
    base_url="https://api.tokensg.ai",
)

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好！"}],
)
print(message.content[0].text)
javascript
import Anthropic from '@anthropic-ai/sdk'

const client = new Anthropic({
  apiKey: 'sk-your-tokensg-key',
  baseURL: 'https://api.tokensg.ai',
})

const message = await client.messages.create({
  model: 'claude-sonnet-4-6',
  max_tokens: 1024,
  messages: [{ role: 'user', content: '你好！' }],
})
console.log(message.content[0].text)
bash
curl https://api.tokensg.ai/v1/messages \
  -H "x-api-key: sk-your-tokensg-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好！"}]
  }'

完整字段参考见 Messages API。

接下来 ​