Spaces:
Paused
Paused
| title: Trae2api | |
| emoji: 🔥 | |
| colorFrom: blue | |
| colorTo: gray | |
| sdk: docker | |
| pinned: false | |
| app_port: 17080 | |
| ## 项目介绍 | |
| Trae2API 是一个将 Trae API 转换为 OpenAI API 格式的服务，仅用于技术交流学习，不可用于任何商业行为！ | |
| 声明：本项目未进行任何逆向、破解，仅提供基于明文HTTP API的包装服务。 | |
| 提示：使用该项目可能会导致您的Trae账号被识别、标记或封禁，请酌情使用！ | |
| ### 功能特点 | |
| * 获取模型列表 | |
| * 多轮对话支持 | |
| * 流式/非流式输出 | |
| * 思考类模型思考内容展示 | |
| * RefreshToken自动刷新/持久化 | |
| ### 不会支持 | |
| * 代理访问，请部署在非国内的其他亚洲区域服务器 | |
| * 多账号轮询永远不会支持，虽然很简单 | |
| ## 环境变量获取指南 | |
| 要使用 Trae2API最新版本，您需要获取以下环境变量。请按照对应指南获取： | |
| ### Mac｜Windows 平台 | |
| 使用搜索工具查询获取: | |
| 1. 安装 `everything｜mac使用其他工具` 搜索工具 | |
| 2. 退出Trae重新登录 | |
| 3. 登录Trae之后,回到显示Login Successful的网页上，复制上面的这个地址栏内容，里面可以获取到 ClientID | |
| 4. 进入Trae发起一次对话 | |
| 5. 使用搜索工具在电脑中全局搜索 `storage.json` 文件获取 RefreshToken、UserID | |
| 6. AppID 固定使用: `6eefa01c-1036-4c7e-9ca5-d891f63bfcd8` | |
| 7. 提示：上述信息获取后请妥善保存，除了RefreshToken，其他可以一直使用 | |
| ### 生成随机 AUTH_TOKEN | |
| 您可以使用以下随机生成的 Token 作为 AUTH_TOKEN。 | |
| *(注：此处原为交互式 Token 生成器，Markdown 中无法实现。请自行生成一个安全的随机字符串。)* | |
| ## 必需的环境变量 | |
| ### APP_ID | |
| Trae API 应用 ID，可从 ai_1_stdout.log 文件中获取 | |
| ### CLIENT_ID | |
| OAuth Client ID，可从 main.log 文件中获取 | |
| ### REFRESH_TOKEN | |
| OAuth Refresh Token，可从 storage.json 文件中获取 | |
| ### USER_ID | |
| User ID，可从 main.log 文件中获取 | |
| ### AUTH_TOKEN | |
| API 访问鉴权 Token，可自定义设置 | |
| 建议使用数字+字母生成的字符串确保安全性，不要包含特殊字符 | |
| ## 可选的环境变量 | |
| ### BASE_URL | |
| 获取模型、对话、获取文件上传Token的基本路径（如果你是亚洲区域，可以忽略此变量） | |
| 默认值：`https://trae-api-sg.mchost.guru` | |
| ### REFRESH_TOKEN_URL | |
| 刷新RefreshToken和Token的基本路径（如果你是亚洲区域，可以忽略此变量） | |
| 默认值：`https://api-sg-central.trae.ai` | |
| ### REFRESH_TOKEN_CACHE_ENABLED **v1.0.7** | |
| 是否开启Redis缓存RefreshToken，开启并配置链接地址后，最新的RefreshToken会被缓存到Redis中，避免误容器重启导致RefreshToken失效 | |
| 默认值：false | |
| ### REDIS_CONN_STRING **v1.0.7** | |
| Redis链接地址，和REFRESH_TOKEN_CACHE_ENABLED搭配使用（推荐白嫖upstash免费额度） | |
| 格式：`redis://:password@redis.example.com:6379`（upstash请使用`rediss//`开头的配置） | |
| ### AUTO_CONTINUE_ENABLED **v1.0.8** | |
| 是否开启Claude3.7自动继续对话，开启后如果对话因为token限制而截断，会自动发起继续请求并维持长链接回复直到内容全部回复完成（继续对话内容中可能包含一些AI回复的无用数据，需要手动删除） | |
| 默认值：false | |
| ### GET_FILE_ID_URL（暂未使用） | |
| 获取上传文件ID的基础路径（如果你是亚洲区域，可以忽略此变量） | |
| 默认值：`https://imagex-ap-singapore-1.bytevcloudapi.com` | |
| ### UPLOAD_FILE_URL（暂未使用） | |
| 上传文件的基础路径（如果你是亚洲区域，可以忽略此变量） | |
| 默认值：`https://tos-sg16-share.vodupload.com` | |
| ## API 使用示例 | |
| ### 获取模型列表 | |
| ```http | |
| GET http://localhost:17080/v1/models | |
| Authorization: Bearer your_auth_token | |
| ``` | |
| ```bash | |
| curl http://localhost:17080/v1/models -H "Authorization: Bearer your_auth_token" | |
| ``` | |
| ### 发起对话 | |
| ```http | |
| POST http://localhost:17080/v1/chat/completions | |
| Authorization: Bearer your_auth_token | |
| Content-Type: application/json | |
| { | |
| "model": "gpt-4o", | |
| "messages": [ | |
| { | |
| "role": "user", | |
| "content": "你好" | |
| } | |
| ], | |
| "stream": false | |
| } | |
| ``` | |
| ```bash | |
| curl http://localhost:17080/v1/chat/completions \ | |
| -H "Authorization: Bearer your_auth_token" \ | |
| -H "Content-Type: application/json" \ | |
| -d '{"model":"gpt-4o","messages":[{"role":"user","content":"你好"}],"stream":false}' | |
| ``` | |
| ### 流式对话 | |
| ```http | |
| POST http://localhost:17080/v1/chat/completions | |
| Authorization: Bearer your_auth_token | |
| Content-Type: application/json | |
| { | |
| "model": "gpt-4o", | |
| "messages": [ | |
| { | |
| "role": "user", | |
| "content": "你好" | |
| } | |
| ], | |
| "stream": true | |
| } | |
| ``` | |
| ```bash | |
| curl http://localhost:17080/v1/chat/completions \ | |
| -H "Authorization: Bearer your_auth_token" \ | |
| -H "Content-Type: application/json" \ | |
| -d '{"model":"gpt-4o","messages":[{"role":"user","content":"你好"}],"stream":true}' | |
| ``` | |
| ## 请求地址环境变量参考 | |
| 根据你注册时使用的节点区域来决定使用哪种环境变量 | |
| ### 亚洲区域环境变量(默认) | |
| ```bash | |
| BASE_URL=https://trae-api-sg.mchost.guru | |
| REFRESH_TOKEN_URL=https://api-sg-central.trae.ai | |
| ``` | |
| ### 美区域环境变量 | |
| ```bash | |
| BASE_URL=https://trae-api-us.mchost.guru | |
| REFRESH_TOKEN_URL=https://api-us-east.trae.ai | |
| ``` | |
| ## 常见问题解决方案 | |
| ### 为什么AI不回答我的问题？ | |
| Trae的Claude3.5被写入了系统提示词，仅会回复代码类问题，可尝试使用claude3.7模型。 | |
| ### 开启claude3.7续答功能返回的代码为什么不能直接运行？ | |
| 续答过程中AI会在开头回复一些无用或者重复内容，需要手动删除。 | |
| ### 为什么我没有找到环境变量？ | |
| 请先向AI发起一次对话，然后再查找相关日志文件。 | |
| ### 为什么我的Trae登录失效/无法使用了？ | |
| Trae2api会使用本地的refreshToken来刷新Token，而refreshToken使用一次之后立即失效，会导致Trae本身记录的refreshToken失效无法刷新Token，如果你有Trae本身的使用需求，建议放弃使用本项目，或者在虚拟机或其他电脑中额外开启一个Trea用来提供2api服务。 | |
| ### refreshToken有效期是多久？ | |
| 目前已知refreshToken可持续刷新，理论字节不调整，可以持续使用。 | |
| ### 为什么容器启动报错refreshToken invalid？ | |
| 当前配置的refreshToken失效了，请退出Trae的账号，重新登录，然后获取最新的refreshToken填入环境变量中,获取之后就不需要再打开Trae了。 | |
| ### 为什么我本地测试接口没问题，用容器启动就会报错？ | |
| Trae在不同的区域调用的是不同的接口地址，目前已知有sg（新加坡）和us（美国）两个不同的地址，默认使用sg的接口，你可以更换地址相关的环境变量以使用指定的接口地址。 | |
| Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference | |