Codex / Hermes / OpenAI 兼容客户端教程

Codex、Hermes、OpenClaw、OpenAI SDK、ccswitch 等客户端使用 OpenAI 兼容配置，Base URL 必须带 /v1。

Codex / Hermes 域名规则

  • Base URL：https://gpt.toupiaoai.com/v1
  • API Key：填写本站后台发放的 API Key。
  • 模型：gpt-5.4 或 gpt-5.5。
  • 推荐先用 gpt-5.4，需要更强能力时再切换到 gpt-5.5。
  • 如果客户端有 Provider 选项，请选择 OpenAI Compatible / Custom OpenAI。

通用填写方式

Base URL: https://gpt.toupiaoai.com/v1
API Key: 你的 API Key
Model: gpt-5.4

OpenAI SDK 示例

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "你的 API Key",
  baseURL: "https://gpt.toupiaoai.com/v1"
});

const response = await client.chat.completions.create({
  model: "gpt-5.4",
  messages: [{ role: "user", content: "你好" }]
});

curl 测试

curl https://gpt.toupiaoai.com/v1/chat/completions   -H "Authorization: Bearer 你的 API Key"   -H "Content-Type: application/json"   -d '{"model":"gpt-5.4","messages":[{"role":"user","content":"请只回复 ok"}]}'

常见错误

  • 401 / Invalid API key：API Key 填错，或使用了别的平台的 Key。
  • 404 / endpoint not found：请确认 Base URL 是 https://gpt.toupiaoai.com/v1。
  • 模型不可用：请确认模型名是 gpt-5.4 或 gpt-5.5。
  • 余额不足：请先到充值兑换页给 API Key 充值。
  • Claude Code 后续独立放在 cc.toupiaoai.com，本 GPT 专线不混用 Claude 配置。
  • 本站公开教程只展示你的中转站入口，不展示上游供应商地址。