⚠️ 警告

请妥善保管 API Key，不要提交到代码仓库或在前端代码中硬编码。

export TOKENFAB_API_KEY="your-api-key"
# Windows PowerShell
$env:TOKENFAB_API_KEY="your-api-key"

pip install openai

from openai import OpenAI

client = OpenAI(api_key="your-api-key", base_url="https://api.tokenfab.cn/v1")

resp = client.chat.completions.create(model="glm-5.2", messages=[{"role":"user","content":"介绍一下 TokenFab 平台"}])
print(resp.choices[0].message.content)

pip install openai

from openai import OpenAI
client = OpenAI(api_key="your-api-key", base_url="https://api.tokenfab.cn/v1")

try:
    r = client.chat.completions.create(model="glm-5.2", messages=[{"role":"user","content":"你好"}])
except Exception as e:
    print(f"错误: {e}")

💡 提示

OpenAI SDK 的兼容功能可直接使用；思考模式、联网搜索等 TokenFab 扩展参数请参照对应章节。

⚠️ 提示

Anthropic 协议当前支持以下模型：glm-5.2、qwen3.7-max、qwen3.7-plus、kimi-k3

import anthropic

client = anthropic.Anthropic(
    api_key="your-api-key",
    base_url="https://api.tokenfab.cn/anthropic",
)

message = client.messages.create(
    model="glm-5.2",
    max_tokens=1024,
    messages=[{"role": "user", "content": "hello"}],
    thinking={"type": "disabled"},
)
print(message.content[0].text)

with client.messages.stream(
    model="glm-5.2",
    max_tokens=1024,
    messages=[{"role": "user", "content": "讲个故事"}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

export ANTHROPIC_BASE_URL="https://api.tokenfab.cn/anthropic"
export ANTHROPIC_AUTH_TOKEN="your-api-key"
export ANTHROPIC_DEFAULT_MODEL="glm-5.2"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-5.2"
export ANTHROPIC_SMALL_FAST_MODEL="glm-5.2"
export CLAUDE_CODE_DEFAULT_HAIKU_MODEL="glm-5.2"
export CLAUDE_CODE_SUBAGENT_MODEL="glm-5.2"

$env:ANTHROPIC_BASE_URL="https://api.tokenfab.cn/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="your-api-key"
$env:ANTHROPIC_DEFAULT_MODEL="glm-5.2"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-5.2"
$env:ANTHROPIC_SMALL_FAST_MODEL="glm-5.2"
$env:CLAUDE_CODE_DEFAULT_HAIKU_MODEL="glm-5.2"
$env:CLAUDE_CODE_SUBAGENT_MODEL="glm-5.2"

提示

上方“从现有安装中迁移”一节中的内容为配置变量，其中 API Key 在控制台获取。

cd /path/to/my-project
claude

openclaw onboard --install-daemon

curl -fsSL https://openclaw.ai/install.sh | bash

iwr -useb https://openclaw.ai/install.ps1 | iex

openclaw dashboard

openclaw terminal

openclaw terminal --model glm-5.2

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

{
  "models": [
    {
      "id": "deepseek-v4-pro",
      "name": "DeepSeek V4 Pro",
      "vendor": "TokenFab",
      "url": "https://api.tokenfab.cn/v1/chat/completions",
      "apiKey": "${{API_KEY}}",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": false,
      "relatedModels": {
        "lite": "deepseek-v4-flash",
        "reasoning": "deepseek-v4-pro"
      }
    },
    {
      "id": "deepseek-v4-flash",
      "name": "DeepSeek V4 Flash",
      "vendor": "TokenFab",
      "url": "https://api.tokenfab.cn/v1/chat/completions",
      "apiKey": "${{API_KEY}}",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": false
    }
  ],
  "availableModels": [
    "deepseek-v4-pro",
    "deepseek-v4-flash"
  ]
}

💡 提示

配置中的 url 使用 OpenAI 兼容的 Chat Completions 端点，确保 apiKey 替换为你实际的 TokenFab API Key，而非环境变量占位符。

🏆 综合最佳 — glm-5.3

1M 超大上下文，旗舰性能。

💻 编程 — deepseek-v4-pro

代码生成、调试、Review。

⚡ 高并发 — qwen3.7-max

毫秒级响应，适合客服、分类等简单任务。

⚠️ 警告

超过上下文限制可能导致回答质量下降或报错。

from openai import OpenAI

client = OpenAI(api_key="your-api-key", base_url="https://api.tokenfab.cn/v1")

stream = client.chat.completions.create(model="glm-5.2", messages=[{"role":"user","content":"讲个故事"}], stream=True)
for chunk in stream:
    if chunk.choices:
        if chunk.choices[0].delta.content:
            print(chunk.choices[0].delta.content, end="", flush=True)

data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","created":1784950000,"model":"glm-5.2","choices":[{"index":0,"delta":{"role":"assistant","content":"今天"},"finish_reason":null}]}
data: {"id":"chatcmpl-xxx","object":"chat.completion.chunk","created":1784950000,"model":"glm-5.2","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}
data: [DONE]

from openai import OpenAI

client = OpenAI(api_key="your-api-key", base_url="https://api.tokenfab.cn/v1")

response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[{"role": "user", "content": "2026年AI行业的最新趋势是什么？"}],
    extra_body={"enable_thinking":True}
)

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

注意

思考模式仅适用于支持该能力的模型，例如 deepseek-v4-pro、glm-5.2、qwen3.7-max；具体以模型能力配置为准。思考模式下 temperature 等参数不生效。

tools = [{"type":"function","function":{"name":"get_weather","description":"查询天气","parameters":{"type":"object","properties":{"city":{"type":"string"}},"required":["city"]}}}]
messages = [{"role":"user","content":"北京天气怎么样？"}]
r1 = client.chat.completions.create(model="glm-5.2", messages=messages, tools=tools)
tc = r1.choices[0].message.tool_calls[0]
              result = "北京今天晴，25℃"
messages.append(r1.choices[0].message)
messages.append({"role":"tool","tool_call_id":tc.id,"content":result})
r2 = client.chat.completions.create(model="glm-5.2", messages=messages)
print(r2.choices[0].message.content)

messages = [{"role":"user","content":"北京天气怎么样？"}]
r1 = client.chat.completions.create(model="glm-5.2", messages=messages)
messages.append({"role":"assistant","content":r1.choices[0].message.content})
messages.append({"role":"user","content":"上海呢？"})
r2 = client.chat.completions.create(model="glm-5.2", messages=messages)

r = client.chat.completions.create(model="glm-5.2", messages=[{"role":"user","content":"列出3种水果及价格"}],
    response_format={"type":"json_schema","json_schema":{"name":"fruits","schema":{"type":"object","properties":{"fruits":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"price":{"type":"number"}},"required":["name","price"]}}},"required":["fruits"]}}})
print(r.choices[0].message.content)

import asyncio
from openai import AsyncOpenAI

client = AsyncOpenAI(api_key="your-api-key", base_url="https://api.tokenfab.cn/v1")

async def ask(q):
    r = await client.chat.completions.create(model="glm-5.2", messages=[{"role":"user","content":q}])
    print(r.choices[0].message.content)

async def main():
    tasks = [ask(q) for q in ["总结AI", "翻译Hello", "推荐3本书"]]
    await asyncio.gather(*tasks)

asyncio.run(main())

💡 提示

适合批量处理。注意并发数不要超过模型限制。

from openai import OpenAI

client = OpenAI(api_key="your-api-key", base_url="https://api.tokenfab.cn/v1")

response = client.chat.completions.create(
    model="glm-5.2",
    messages=[{"role": "user", "content": "2026年AI行业的最新趋势是什么？"}],
    extra_body={"enable_web_search": True}
)

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

注意

联网搜索会增加响应延迟，仅在需要实时信息时开启。搜索会消耗额外 Token，计入总用量。

curl -X POST https://api.tokenfab.cn/v1/chat/completions \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.2",
    "messages": [
      {"role": "system", "content": "你是一个翻译助手"},
      {"role": "user", "content": "把以下英文翻译成中文：Hello World"}
    ],
    "temperature": 0.7,
    "max_tokens": 1024
  }'

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "glm-5.2",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "你好世界"
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 28,
    "completion_tokens": 5,
    "total_tokens": 33
  }
}

curl https://api.tokenfab.cn/v1/models \
  -H "Authorization: Bearer your-api-key"

{"object":"list","data":[
  {"id":"aicc-doubao-seedance-2-0","object":"model","owned_by":"tokenfab"},
  {"id":"deepseek-v4-flash","object":"model","owned_by":"tokenfab"},
  {"id":"deepseek-v4-pro","object":"model","owned_by":"tokenfab"},
  {"id":"glm-5.2","object":"model","owned_by":"tokenfab"},
  {"id":"glm-5.3","object":"model","owned_by":"tokenfab"},
  {"id":"happyhorse-1.1-i2v","object":"model","owned_by":"tokenfab"},
  {"id":"happyhorse-1.1-r2v","object":"model","owned_by":"tokenfab"},
  {"id":"happyhorse-1.1-t2v","object":"model","owned_by":"tokenfab"},
  {"id":"kimi-k2.6","object":"model","owned_by":"tokenfab"},
  {"id":"kimi-k2.7-code","object":"model","owned_by":"tokenfab"},
  {"id":"kimi-k3","object":"model","owned_by":"tokenfab"},
  {"id":"occupancy-hold","object":"model","owned_by":"tokenfab"},
  {"id":"qwen3.7-max","object":"model","owned_by":"tokenfab"},
  {"id":"qwen3.7-max-2026-06-08","object":"model","owned_by":"tokenfab"},
  {"id":"qwen3.7-plus","object":"model","owned_by":"tokenfab"},
  {"id":"viduq3-pro","object":"model","owned_by":"tokenfab"},
  {"id":"viduq3-turbo","object":"model","owned_by":"tokenfab"}
]}

注意

如有更高并发需求请联系技术支持扩容。超限返回 HTTP 429。

{"error":{"code":"invalid_api_key","message":"身份验证失败，请检查 API Key"}}

from langchain_openai import ChatOpenAI
llm = ChatOpenAI(model="glm-5.2", api_key="your-api-key", base_url="https://api.tokenfab.cn/v1")
response = llm.invoke("介绍一下深度学习")

💡 提示

LlamaIndex、Semantic Kernel 等兼容 OpenAI SDK 的框架均可直接接入。

curl -X POST https://api.tokenfab.cn/v1/videos \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-t2v",
    "prompt": "一只金色小狗在草地上奔跑，阳光明媚，镜头跟随",
    "seconds": "5",
    "size": "1080P"
  }'

# 响应示例
# {"id":"vid-abc123","status":"queued","created_at":"2026-07-01T12:00:00Z"}

# 查询任务状态
curl https://api.tokenfab.cn/v1/videos/vid-abc123 \
  -H "Authorization: Bearer your-api-key"

# 响应示例（处理中）
# {"id":"vid-abc123","status":"processing","progress":45}

# 响应示例（已完成）
# {"id":"vid-abc123","status":"completed","url":"https://cdn.tokenfab.cn/...mp4"}

# 下载视频
curl -O https://api.tokenfab.cn/v1/videos/vid-abc123/content \
  -H "Authorization: Bearer your-api-key"

注意

视频生成任务耗时较长。创建不是幂等的——网络超时后先排查已有任务，不要盲目重复 POST。

curl -X POST https://api.tokenfab.cn/v1/videos \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-i2v",
    "prompt": "镜头缓慢推进，女孩微微转头微笑",
    "input_reference": "https://example.com/photo.jpg",
    "seconds": "5",
    "size": "1080P"
  }'

curl -X POST https://api.tokenfab.cn/v1/videos \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-r2v",
    "prompt": "[Image 1] 中的人物在街上行走，保持穿搭风格一致",
    "reference_images": [
      "https://example.com/ref1.jpg",
      "https://example.com/ref2.jpg"
    ],
    "seconds": "5",
    "size": "1080P"
  }'

curl -X POST https://api.tokenfab.cn/v1/videos \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq3-turbo",
    "prompt": "从白天到黑夜的城市天际线变化，灯光逐渐亮起",
    "input_reference": "https://example.com/first_frame.jpg",
    "last_frame": "https://example.com/last_frame.jpg",
    "seconds": "5",
    "size": "1080P"
  }'