TYASAI · OFFICIAL WIKI

TyasAI Wiki

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

官网 / 控制台https://api.tyasai.com/

API 接口地址 / Base URLhttps://api.tyasai.com/v1

第一次用，从这里开始

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

Cline / Roo / Continue / Cursor

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

复制三项配置 →

Codex

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

看 Codex 步骤 →

Claude Code

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

看 Claude 判断 →

Hermes

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

看 Hermes 步骤 →

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

先认识三项配置

Base URL：服务地址，像网页登录地址一样复制进去。

API Key：你的专属钥匙，别人拿到就能花你的额度，不要公开。

Model：模型名称，先填 gpt-5.5。

Base URLhttps://api.tyasai.com/v1

API Key你的 TyasAI API Key

Modelgpt-5.5

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

可以直接复制给客户

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

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 测试。

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"。

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

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

Hermes：从打开文件夹开始

Hermes 要改两个文件：

config.yaml写“用哪个服务、哪个模型”

.env写“你的 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

OpenClaw / 龙虾

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

打开终端。

先把 Key 放进环境变量。

运行配置向导。

按屏幕问题选择。

export CUSTOM_API_KEY="你的 TyasAI API Key"
openclaw onboard --flow advanced

模式选 local。
供应商选 Custom API Key / Custom Provider。
Key 输入方式选 Environment variable / ref。
Provider ID 填 tyasai。
Base URL 填 https://api.tyasai.com/v1。
Model ID 填 gpt-5.5。
Compatibility 选 openai / Chat Completions。

开发者示例

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"}]}'

常见问题

401 / API_KEY_REQUIRED

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

404 / Not Found

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

Claude Code 不能用

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

配置文件夹打不开

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

安全提醒

不要把 API Key 发到群里、网页里或 GitHub。
网页登录/控制台只打开 https://api.tyasai.com/；工具/API Base URL 只填 https://api.tyasai.com/v1。
不要使用内部维护地址、临时地址或内网地址。