TQTyasAI Wikiofficial guide

TYASAI · OFFICIAL WIKI

TyasAI Wiki

给普通客户看的接入配置说明。你不需要懂 API，只要知道自己用哪个工具，然后照着对应步骤把三项信息填进去。

入口地址https://api.tyasai.com/v1
00

第一次用，从这里开始

先确认你准备用哪个工具。不要先看代码，不要先改配置文件。

Cline / Roo / Continue / Cursor

最简单。打开软件设置，选择 OpenAI Compatible，填三项。

复制三项配置 →

Codex

需要改电脑里的配置文件。下面会教你怎么打开文件夹、怎么新建文件。

看 Codex 步骤 →

Claude Code

先判断有没有 CC Switch 或本地网关，不能直接乱填 Anthropic 地址。

看 Claude 判断 →

Hermes

主要改两个文件：config.yaml 和 .env。下面从打开文件夹开始写。

看 Hermes 步骤 →

如果你不知道自己用哪个工具，把工具截图发给技术支持。

01

先认识三项配置

Base URL：服务地址，像网页登录地址一样复制进去。
API Key：你的专属钥匙，别人拿到就能花你的额度，不要公开。
Model：模型名称，先填 gpt-5.5。
https://api.tyasai.com/v1
你的 TyasAI API Key
gpt-5.5

Base URL 只填到 /v1，不要多写 /chat/completions。

02

可以直接复制给客户

Provider: OpenAI Compatible / Custom OpenAI
Base URL: https://api.tyasai.com/v1
API Key: <TYASAI_API_KEY>
Model: gpt-5.5
03

Cline / Roo / Continue / Cursor 怎么填

打开工具的 Settings / 设置。
找到 Provider / API Provider / Model Provider。
选择 OpenAI Compatible、Custom OpenAI 或“自定义 OpenAI”。
Base URL 填 https://api.tyasai.com/v1。
API Key 填你的 TyasAI Key。
Model 填 gpt-5.5。
保存后发一句 ping 测试。
04

Codex：不会终端也能找配置

Codex 通常需要改一个叫 config.toml 的文件。这个文件在你电脑里，不是网页。

方法 A：Mac 访达打开

打开 Mac 的 访达 Finder。
顶部菜单点：前往 → 前往文件夹…。
粘贴路径：~/.codex。
如果打不开，说明文件夹还没创建，让技术支持帮你，或用下面终端命令。
在里面找到或新建 config.toml。
用文本编辑器打开，不要用 Word。

方法 B：会终端，直接复制

mkdir -p ~/.codex
open -R ~/.codex

config.toml 粘贴内容

model = "gpt-5.5"
openai_base_url = "https://api.tyasai.com/v1"

设置 API Key

export OPENAI_API_KEY="你的 TyasAI API Key"
codex
长期生效
echo 'export OPENAI_API_KEY="你的 TyasAI API Key"' >> ~/.zshrc
source ~/.zshrc
高级：独立 TyasAI provider
model = "gpt-5.5"
model_provider = "tyasai"

[model_providers.tyasai]
name = "TyasAI"
base_url = "https://api.tyasai.com/v1"
env_key = "TYASAI_API_KEY"
wire_api = "chat"

没验证 /v1/responses 前，不要改成 wire_api = "responses"。

05

Claude / Claude Code：先判断能不能直接填

Cline / Roo / Continue 这类支持 OpenAI Compatible 的工具，可以直接填 TyasAI。
Claude Code 原生命令行 不要直接把 TyasAI 填进 Anthropic 地址。
如果你有 CC Switch 或本地网关，并且它明确支持协议转换，可以通过它接 Claude Code。

Claude Code 配置文件在哪里？

常见位置：

~/.claude/settings.json
打开访达 Finder。
菜单点 前往 → 前往文件夹…。
输入 ~/.claude。
找到或新建 settings.json。
mkdir -p ~/.claude
open -R ~/.claude
不要这样填：
不要把 ANTHROPIC_BASE_URL 直接写成 https://api.tyasai.com/v1，因为 Claude Code 原生协议不是 OpenAI 协议。

通过 CC Switch 使用 Claude Code

  1. 打开 CC Switch。
  2. 新增 Provider：TyasAI。
  3. Base URL 填 https://api.tyasai.com/v1。
  4. API Key 填 TyasAI Key。
  5. Model 填 gpt-5.5。
  6. 应用目标选择 Claude Code。
  7. 如果有“协议转换 / OpenAI to Anthropic / Local Gateway”，打开。
  8. 保存后重启 Claude Code。
06

Hermes：从打开文件夹开始

Hermes 要改两个文件：

写“用哪个服务、哪个模型”
写“你的 API Key”

第一步：打开 Hermes 文件夹

打开访达 Finder。
菜单点 前往 → 前往文件夹…。
输入 ~/.hermes。
如果打不开，说明文件夹还没创建，让技术支持帮你，或用下面终端命令。
mkdir -p ~/.hermes
open -R ~/.hermes

第二步：创建/修改 .env

在 ~/.hermes 里找到 .env。如果没有，就新建纯文本文件，名字必须叫 .env。

TYASAI_API_KEY=你的 TyasAI API Key

第三步：创建/修改 config.yaml

providers:
  tyasai:
    type: openai
    base_url: https://api.tyasai.com/v1
    key_env: TYASAI_API_KEY
    default_model: gpt-5.5

model: tyasai/gpt-5.5
如果你的 Hermes 使用 custom_providers
custom_providers:
  - name: tyasai
    type: openai
    base_url: https://api.tyasai.com/v1
    key_env: TYASAI_API_KEY
    models:
      - gpt-5.5

model: tyasai/gpt-5.5

第四步：验证

hermes config
hermes config check
hermes chat --model tyasai/gpt-5.5
07

OpenClaw / 龙虾

OpenClaw 不建议手改 JSON。普通客户直接走向导。

打开终端。
先把 Key 放进环境变量。
运行配置向导。
按屏幕问题选择。
export CUSTOM_API_KEY="你的 TyasAI API Key"
openclaw onboard --flow advanced
  1. 模式选 local。
  2. 供应商选 Custom API Key / Custom Provider。
  3. Key 输入方式选 Environment variable / ref。
  4. Provider ID 填 tyasai。
  5. Base URL 填 https://api.tyasai.com/v1。
  6. Model ID 填 gpt-5.5。
  7. Compatibility 选 openai / Chat Completions。
08

开发者示例

Python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["TYASAI_API_KEY"],
    base_url="https://api.tyasai.com/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "ping"}],
)
print(resp.choices[0].message.content)
curl
curl https://api.tyasai.com/v1/chat/completions \
  -H "Authorization: Bearer <TYASAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"ping"}]}'
09

常见问题

401 / API_KEY_REQUIRED

Key 没填、填错，或没有按工具要求保存。

404 / Not Found

Base URL 写错，常见是多写了 /chat/completions。

Claude Code 不能用

先确认有没有 CC Switch 或本地网关做协议转换。

配置文件夹打不开

说明文件夹还没创建，找技术支持，或复制文档里的 mkdir -p 命令创建。

10

安全提醒

  • 不要把 API Key 发到群里、网页里或 GitHub。
  • 客户只使用 https://api.tyasai.com/v1。
  • 不要使用内部维护地址、临时地址或内网地址。