TyasAI 文档站

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

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

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

三种能力用不同的 Key、不同的接口。控制台买哪一类卡，就用哪一类 Key。不要混用。

复制POST https://api.tyasai.com/v1/chat/completions

复制POST https://api.tyasai.com/v1/responses

复制curl https://api.tyasai.com/v1/chat/completions \
  -H "Authorization: Bearer 你的文本Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role":"user","content":"你好"}]
  }'

复制POST https://api.tyasai.com/v1/images/generations

复制curl https://api.tyasai.com/v1/images/generations \
  -H "Authorization: Bearer 你的生图Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只坐在窗边的橘猫，暖光，写实",
    "size": "1024x1536"
  }'

复制import os
from openai import OpenAI

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

img = client.images.generate(
    model="gpt-image-2",
    prompt="一只坐在窗边的橘猫，暖光，写实",
    size="1024x1536",
)
print(img.data[0].b64_json or img.data[0].url)

复制POST https://api.tyasai.com/v1/videos
POST https://api.tyasai.com/v1/videos/generations

复制GET https://api.tyasai.com/v1/videos/{任务ID}

复制GET https://api.tyasai.com/v1/videos/{任务ID}/content

复制curl https://api.tyasai.com/v1/videos \
  -H "Authorization: Bearer 你的视频Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "海边日落，镜头缓慢推进"
  }'

复制curl https://api.tyasai.com/v1/videos/任务ID \
  -H "Authorization: Bearer 你的视频Key"

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

方法 A：Mac 访达打开

方法 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

复制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"

Claude Code 配置文件在哪里？

常见位置：

复制~/.claude/settings.json

复制mkdir -p ~/.claude
open -R ~/.claude

通过 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。

Hermes 要改两个文件：

第一步：打开 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

复制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 不建议手改 JSON。普通客户直接走向导。

复制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。

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