Dify、LangChain 和 n8n 怎么接入 Tikway?
使用支持自定义基础地址的 OpenAI 兼容客户端时,将 Base URL 配置为 https://api.tikway.ai/v1,并填写自己的 Tikway API Key 和模型目录中的完整模型 ID。教程按工具各自的配置方式说明,实际拼接出的文本请求应为 /v1/chat/completions。
Dify 通过 OpenAI-API-compatible 模型供应商接入;LangChain 使用 ChatOpenAI 的自定义 base_url;n8n 在 OpenAI 凭证与 OpenAI Chat Model 节点中配置,再把模型节点连接到 AI Agent。工具版本和所选模型会影响可用功能,接入时按教程分步验证。
- 先用最小文本请求验证地址、Key 和型号。
- Chat Completions 与 Responses 是不同端点,按模型目录与客户端设置选择。
- 模型返回工具调用后,由 Agent 应用执行工具并把结果回传。
智能体选模型,要看工具调用和上下文
Agent 的输入通常包含系统提示词、工具说明、历史消息和工具结果。模型选择需要同时考虑当前端点、工具调用能力、上下文窗口和输出限制;型号名称相近也应按完整 ID 分别核对。
在模型目录查看支持的协议、端点和能力,先用一个只读工具检查工具名、参数以及回传结果,再逐步增加工具和历史消息。普通文本请求成功只说明基本连接可用。
- Function Calling / Tool Calling:检查所选模型和协议是否支持。
- 长上下文:把工具定义和历史记录一起计入输入预算。
- 任务质量:用自己的固定任务比较完成率、重试次数和总费用。
把工具调用跑完整,才能判断 Agent 是否接好
一个最小工具循环包括:发送工具定义、读取模型返回的工具名与参数、在应用侧执行工具、按对应调用 ID 回传结果,然后读取最终回答。模型 API 负责生成调用请求;实际工具执行由 Dify、LangChain、n8n 或你的应用完成。
从查询本地时间、读取示例数据这类无副作用任务开始。给循环设置轮数、超时和重试上限,校验参数,并记录是哪一步失败。MCP 工具需要在应用或框架侧配置连接,不能只凭模型 API 地址判断是否接入。
- 401:核对 Tikway Key、Bearer 认证和客户端配置。
- 404:检查是否重复追加 /v1,以及是否用了不同 API 端点。
- 工具没有执行:分别检查模型能力、工具绑定、参数和结果回传。
Agent 多轮调用的费用,按整次任务核对
一次 Agent 任务可能触发多次模型请求。工具定义、历史消息和工具结果会进入后续轮次的上下文;重试和长输出也会增加总用量。比较模型价格时,将每轮输入、输出和适用附加费用相加,再看整次任务是否完成。
先用费用计算器估算普通文本的单轮基础费用,再根据实际调用记录累计多轮用量。缓存、工具所访问的外部服务以及图像等费用需要按相应规则单独核对。
- 设置最大轮数和单轮输出限制。
- 保存实际模型 ID、响应状态、Token 用量和失败原因。
- 先衡量任务总成本,再决定是否增加上下文或更换模型。
请求地址与协议
| 配置项 | 值或核对方法 |
|---|---|
| OpenAI 兼容 Base URL | https://api.tikway.ai/v1 |
| 文本请求完整端点 | POST https://api.tikway.ai/v1/chat/completions |
| 认证 | Authorization: Bearer <你的 Tikway API Key> |
| 模型 | 从模型目录复制完整调用 ID,并核对当前端点和工具调用能力 |
| 工具循环 | 应用发送 tools,读取 tool_calls,执行工具后回传对应 tool_call_id 的结果 |
先核对价格,再估算预算
普通文本基础费用 = 输入 Token × 输入单价 + 输出 Token × 输出单价
模型目录的基础价格以美元、每 Token 展示;比较每百万 Token 报价时需乘以 1,000,000。计算器仅估算普通文本基础费用,缓存、图片、视频和其他附加费用需另行核对,最终以账户计费规则及调用记录为准。
接入与排错资料
常见问题
Tikway 提供的是 Agent 应用还是模型 API?
这里介绍的是为 Agent 应用接入模型 API。提示词、工具、记忆和执行流程由你的框架或应用管理;Tikway 提供模型调用入口、公开模型信息和相关接入资料。
支持 OpenAI 兼容 API 就能使用所有 Agent 功能吗?
具体功能取决于所选模型、协议、端点以及客户端。先核对工具调用能力,再验证一轮工具请求和结果回传;文本、流式、工具调用和 Responses 需要分别检查。
怎样核对 Agent 调用的模型与费用?
使用目录中的完整模型 ID,保存请求与响应中的型号信息,并结合账户调用记录核对输入输出 Token 和费用。这些信息便于排错和费用核算;回答风格本身不能证明底层模型身份。