Let AI Run API 接入文档

本文档为站内渲染版本，建议先完成控制台登录并创建 Token，再进行接口联调。

1. 基础信息

网站地址：https://api.letai.run/
API Base URL：https://api.letai.run/v1
CN2 国内加速 API Base URL：https://cn-api.letai.run/v1
协议兼容：OpenAI Chat Completions / Embeddings
鉴权方式：Authorization: Bearer <YOUR_TOKEN>
返回格式：application/json

2. 快速调用示例

curl --request POST \
  --url https://api.letai.run/v1/chat/completions \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "请用一句话介绍 Let AI Run。"}
    ],
    "stream": false
  }'

如需国内加速，可将请求地址替换为 https://cn-api.letai.run/v1/chat/completions。

3. 常用请求头

Header	必填	说明
`Authorization`	是	Bearer Token
`Content-Type`	是	固定 `application/json`
`x-request-id`	否	建议携带，便于链路追踪

4. 错误码说明

code	含义	建议处理方式
`401`	Token 无效或过期	重新登录并刷新 Token
`403`	无权限访问模型或分组	检查账号权限和策略
`429`	触发限流	退避重试，降低并发
`500`	上游或网关内部错误	记录 `x-request-id` 并联系支持

5. 生产环境建议

所有请求都打上业务侧请求 ID。
对 429 和 5xx 做指数退避重试。
在服务端托管密钥，不要将主密钥暴露到前端。
建议在网关前增加熔断与超时控制。

6. 参考链接

仓库首页：/
公益计划：/welfare
管理后台：/dashboard
平台开放接口（第三方服务端）：