接入指南

为你的 Agent 加上实时意图防护和 Token 优化，只需三步配置。

接入规范（必须遵守）

1. base_url
https://your-gateway.domain.com/v1
2. api_key
sk-xxxx（Torin 生成的虚拟 Key）
3. model

必须填写，且与「密钥仓库」中绑定的模型名称一致

快速开始（3 分钟）

  1. 登录 Torin 仪表盘 → 生成网关虚拟 API Key
  2. 前往密钥仓库，绑定你的真实 LLM API Key（OpenAI / DeepSeek / Anthropic 等）
  3. 在 Agent 中修改配置：
    • base_url → 你的 Torin 网关地址
    • api_key → Torin 生成的虚拟 Key
    • model → 你绑定的模型名称（如 deepseek-chat）
      • 网关完全兼容 OpenAI Chat Completion 格式，任何使用该格式的框架均可无缝接入。

主流 Agent 接入教程

Trae（字节跳动）

AI IDE / Agent 开发平台

  1. 在 Torin 生成网关 Key，并在密钥仓库绑定 LLM Key
  2. 进入 Trae 设置 → 模型 → 添加自定义模型
  3. 选择 OpenAI Chat Completion 格式
  4. Base URL 填写 Torin 网关地址
  5. API Key 填写 Torin 虚拟 Key
  6. Model ID 填写你绑定的模型名称（如 deepseek-chat）

Cursor

AI 编程 IDE/ Agent开发平台

  1. 打开 Cursor 设置
  2. 搜索并进入 'Custom Models' 或 'Model'
  3. 添加新 Provider → OpenAI Compatible/ 选择API keys 添加
  4. OpenAI Base URL 填写 Torin 网关地址
  5. OpenAI API Key 填写 Torin 虚拟 Key
  6. Add Custom Model 添加model-填写你绑定的模型名称

Claude Computer Use

Claude 原生电脑控制 Agent

  1. 使用 Anthropic SDK 或官方客户端
  2. 将 base_url 设置为 Torin 网关地址
  3. api_key 使用 Torin 生成的虚拟 Key
  4. 在 Torin 密钥仓库绑定你的 Anthropic Key
  5. model 名称保持一致（如 claude-3-5-sonnet-20241022）

CrewAI

多 Agent 协作框架

  1. 在项目 .env 文件中配置：
  2. OPENAI_API_BASE=https://your-gateway.domain.com/v1
  3. OPENAI_API_KEY=sk-xxxx（Torin 虚拟 Key）
  4. 在 Torin 密钥仓库绑定对应 LLM Key
  5. 重启项目即可生效

AutoGPT / OpenClaw

经典全自动 Agent

  1. 修改环境变量或配置文件：
  2. OPENAI_API_BASE = 你的 Torin 网关地址
  3. OPENAI_API_KEY = Torin 生成的虚拟 Key
  4. 在密钥仓库绑定实际 LLM Key

Dify / Coze

可视化 Agent 构建平台

  1. 进入应用设置 → LLM 提供商
  2. 添加自定义 OpenAI 兼容模型
  3. Base URL 填写 Torin 网关地址
  4. API Key 填写 Torin 虚拟 Key
  5. Model Name 填写你绑定的模型

通用代码示例

Python (OpenAI SDK)

import openai

client = openai.OpenAI(
    base_url="https://your-gateway.domain.com/v1",
    api_key="sk-xxxxxxxxxxxxxxxxxxxxxxxx",   # Torin 虚拟 Key
)

response = client.chat.completions.create(
    model="deepseek-chat",                   # 必须填写
    messages=[{"role": "user", "content": "你的问题"}]
)

LangChain

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    base_url="https://your-gateway.domain.com/v1",
    api_key="sk-xxxxxxxxxxxxxxxxxxxxxxxx",
    model="deepseek-chat"   # 必须填写
)

⚠️ 关于 LLM API Key 的重要说明

目前 Torin 网关采用用户自带 LLM 模型 API 服务的方式运行。请在「密钥仓库」中绑定你自己购买的 OpenAI、DeepSeek、Anthropic 等 LLM 提供商的 API Key。

未来计划：Torin 将推出统一 LLM API 额度购买服务，用户可直接在平台内购买更优惠的 Token 额度，无需自行管理多个 LLM Key。

⚠️ 重要提醒

  • • model 参数必须填写，且需与你在密钥仓库中绑定的模型名称完全一致
  • • 未在密钥仓库绑定 LLM Key 时，请求会失败
  • • 支持流式（stream=True）和非流式请求，均已覆盖意图检测
  • • 可在「设置」中调整漂移检测的敏感度阈值，以适配不同任务场景