TelangpuAI 使用文档

快速开始

Base URL

https://telangpuai.com/v1

API Key

登录 TelangpuAI 后，在「密钥管理」中创建。

推荐协议

responses

接入步骤

1. 创建 Key
2. 获取模型
3. 选择自己的使用方式（Codex / CC Switch / Codex-X / API）
4. 保存 / 启用
5. 重启 Codex

获取模型

查看当前 Key 可见的模型列表。

Windows PowerShell

$env:TELANGPUAI_API_KEY="sk-你的Key"
(curl.exe https://telangpuai.com/v1/models -H "Authorization: Bearer $env:TELANGPUAI_API_KEY" | ConvertFrom-Json).data | ForEach-Object { $_.id }

macOS / Linux

export TELANGPUAI_API_KEY="sk-你的Key"

curl -s https://telangpuai.com/v1/models \
  -H "Authorization: Bearer $TELANGPUAI_API_KEY"

模型以 /v1/models 实际返回结果为准。

Codex 快速接入

编辑 ~/.codex/config.toml（不存在则创建），填入以下推荐配置：

model = "gpt-5.6-sol"
model_provider = "telangpuai"

[model_providers.telangpuai]
name = "TelangpuAI"
base_url = "https://telangpuai.com/v1"
env_key = "TELANGPUAI_API_KEY"
wire_api = "responses"
requires_openai_auth = false

模型名请换成 /v1/models 返回的真实模型 ID。

Key 不写进 config.toml，通过环境变量提供。

Windows

setx TELANGPUAI_API_KEY "sk-你的Key"

设置后重新打开终端 / Codex。

macOS / Linux

export TELANGPUAI_API_KEY="sk-你的Key"

如需长期生效，写入 ~/.zshrc 或 ~/.bashrc；设置后重新打开终端 / Codex。

CC Switch 快速接入

1. 打开 CC Switch
2. 切到 Codex 管理页
3. 添加供应商
4. 填下面这些参数：

字段	填写
名称	TelangpuAI
Base URL	https://telangpuai.com/v1
API Key	用户自己的 Key
Wire API / 协议	responses
模型	从 /v1/models 获取

然后：保存 → 启用 → 完全退出并重启 Codex

Codex-X 快速接入

1. 打开 Codex-X
2. 进入供应商管理
3. 添加供应商
4. 填下面这些参数：

字段	填写
名称	TelangpuAI
Base URL	https://telangpuai.com/v1
API Key	用户自己的 Key
Wire API	responses
模型	从 /v1/models 获取

然后：保存 → 启用 → 重启 Codex

使用 CC Switch / Codex-X 时，建议在工具内管理配置，不要同时手改同一份 Codex Provider 配置。

统一 API：一把 Key 多模型

使用「统一 API」Key 时，一把 Key 可以访问多个已开放模型，无需为不同模型分别创建 Key。

实际可用模型以 /v1/models 返回结果为准。

API 接口

GET /v1/models

获取当前 Key 可见模型。

curl https://telangpuai.com/v1/models \
  -H "Authorization: Bearer $TELANGPUAI_API_KEY"

POST /v1/responses

curl https://telangpuai.com/v1/responses \
  -H "Authorization: Bearer $TELANGPUAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "你好"
  }'

POST /v1/chat/completions

curl https://telangpuai.com/v1/chat/completions \
  -H "Authorization: Bearer $TELANGPUAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "messages": [
      {
        "role": "user",
        "content": "你好"
      }
    ]
  }'

错误说明

快速判断：

• 4xx：优先检查请求、Key、权限、模型、账户状态
• 5xx：通常与服务器、上游、超时或线路有关

4xx

状态码	常见原因
400	请求格式或参数错误
401	Key 缺失、错误或失效
403	当前 Key 无访问权限
404	路径、模型或资源不存在
413	请求内容过大
429	请求过快或触发限制

5xx

状态码	常见原因
500	服务内部异常
502	网关或上游异常
503	服务或上游暂时不可用
504	上游响应超时
524	Cloudflare 等待源站响应超时

偶发 5xx 可稍后重试；持续出现时可切换其他可用模型。