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

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

Codex / Hermes 域名规则

  • Base URL:https://api.toupiaoai.com/v1
  • API Key:填写本站后台发放的 API Key。
  • 模型:gpt-5.4gpt-5.5claude-sonnet-4-6claude-sonnet-4-5claude-opus-4-7
  • Codex / Hermes 建议使用 gpt-5.5;轻量任务可切换 gpt-5.4
  • 如果客户端有 Provider 选项,请选择 OpenAI Compatible / Custom OpenAI。

通用填写方式

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

OpenAI SDK 示例

import OpenAI from "openai";

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

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

curl 测试

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

常见错误

  • 401 / Invalid API key:API Key 填错,或使用了别的平台的 Key。
  • 404 / endpoint not found:请确认 Base URL 是 https://api.toupiaoai.com/v1
  • 模型不可用:请确认模型名在当前 Key 允许模型范围内,例如 gpt-5.4gpt-5.5claude-sonnet-4-6claude-sonnet-4-5claude-opus-4-7
  • 余额不足:请先到充值兑换页给 API Key 充值。
  • GPT 与 Claude 共用统一 API 入口,系统会按模型名自动选择上游池。
  • 本站公开教程只展示你的中转站入口,不展示上游供应商地址。