欢迎使用码世界-TheWorld Codes 使用文档

超级管理员测试账号 · 2026-06-06T17:02:32.430Z

Excerpt 统一的 AI 模型聚合与分发网关，提供 OpenAI、Claude、Gemini 兼容接口与客户端接入指南。码世界-TheWorld Codes 海量 AI 模型连接全球算力，构建无限可能！一个统一的 AI 模型聚合与分发网关。你可以用一个控制台管理 API Key、余额、用量和调用日志，并把常用客户端接到同一个接口地址。三步开始打开码世界控制台注册账号。在控制台创建一个 API Key。在客户端里填写接口地址和 Key。 Base URL: API Key: 在控制台创建当前公告模型平台公告中已列出的模型包括： gpt-5.5 gpt-5.4 gpt-5.4-mini gpt-5.3-codex gpt-image-2 实际可用模型和价格以控制台显示为准。第一次调用 bash curl \ -H "Authorization: Bearer sk-your-api-key" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-5.4-mini", "messages": [ { "role": "user", "content": "你好，介绍一下自己" } ] }' 注册账号进入控制台后完成注册与登录，再进入密钥管理页进行创建即可开始接入。创建 API Key 建议为不同项目单独创建 Key，方便在控制台里按用途区分与停用。充值与用量余额、消费记录和调用日志集中在同一个后台页面中查看，便于排查异常请求。图像生成如果客户端支持 OpenAI 兼容格式，可按同样的 Base URL 接入图像生成能力。错误码说明接入报错时优先检查 Base URL、Authorization 头和模型名称是否填写正确。客户端配置常见客户端包括 Cherry Studio、CC Switch、Lobe Chat、AionUI 与 OpenCat。在这些客户端中，通常需要统一填写接口地址（Base URL）和控制台创建的 API Key。强烈推荐使用CC Switch 下载地址：支持直接导入：也可以自行添加配置： 📌 中转API基础配置指南接口地址 (Base URL)：统一填写（注意：原 helpapis.com 已废弃）。 API Key：填入你在中转控制台生成的令牌（格式通常为 sk-...）。 💡 核心中转知识：Base URL 的拼接规范绝大多数客户端在设计时，会自动在填写的 Base URL 后面拼接具体端点（如 /chat/completions）。因此，在中转站配置时，接口地址必须以 /v1 结尾，且结尾通常不要加斜杠 /。 🟩 正确示例： 🟥 错误示例： /v1/chat/completions/chat/completions 从而报 404 错误）。 🖥️ 常见通用客户端官方文档 Cherry Studio 配置与使用 —— 支持全平台的桌面级大模型客户端。 CC Switch (CC Desktop Switch) 配置 —— 专为 Claude 桌面客户端及大模型通道切换设计的全能工具。 Lobe Chat 官方配置文档 —— 现代化、支持高颜值 UI 及插件系统的开源 AI 框架。 AionUI 官方页面 —— 针对 AI 智能体与自动化流设计的 UI 客户端。 OpenCat 配置指引 —— 针对 macOS/iOS 平台深度优化的原生大模型客户端。 🛠️ CLI 命令行与独立工具部署 Claude Code、Codex、Gemini CLI 这类专业级开发者工具建议按样板独立成部署页，避免版本说明与基础客户端的快速开始相混淆。这类工具通常需要在本地终端配置环境变量。 Claude Code 官方部署文档 —— Anthropic 官方推出的终端 AI 编码助手，中转配置需格外注意厂商兼容性。 Codex 部署与使用 —— 代码补全与终端效率工具。 Gemini CLI 官方文档 —— 将谷歌 Gemini 能力直接带入终端的命令行工具。 💡 中转进阶知识：终端环境变量配置在使用上述 CLI 工具时，通常通过在终端执行命令来临时或永久挂载中转接口： bash Linux / macOS 配置示例 export OPENAIBASEURL=" " export OPENAIAPIKEY="sk-xxxxxx" Claude Code 专用（若中转站支持兼容通道） export ANTHROPICBASEURL=" " 在线测试文档中提供聊天测试与绘图测试入口。强烈建议您在首次使用、购买新套餐或中转迁移后，优先在此处进行验证。这不仅能确认账户余额与模型可用性，还能帮你排查是否是本地网络阻断了中转站。常见问题与中转排查手册如果遇到连接失败、模型不可用或余额异常，优先回看控制台日志和接口地址配置。 🎯 黄金排查法则网络连接失败 / 连不上服务器 - 检查跨域 (CORS) 问题：如果您在 Web 端客户端（如自建的 Lobe Chat 网页版）使用中转，请确保中转站后端已开启跨域允许。 - 流式传输 (Stream) 异常：部分代理服务或 CDN（如开启了某些特殊缓存规则的 Cloudflare）可能会拦截 text/event-stream 导致打字机效果失效。请确保中转通道的 SSE（Server-Sent Events）未被拦截。模型不可用 (Model Not Found / 404) - 请检查你在客户端输入的模型名称（如 gpt-4o, claude-3-5-sonnet）是否与中转站控制台“可用模型列表”中的官方别名完全一致。大小写、横杠错误都会导致请求失败。余额异常 / 401 Unauthorized - 401 错误：代表 API Key 错误、已过期或已被封禁，请去控制台重新复制最新的令牌。 - 高倍率扣费疑问：不同模型在中转站通常设有不同的“扣费倍率（或权重）”，多模态模型（如带有图片输入）的输入 Token 计费与纯文本不同，请参考控制台的“模型费率说明页”。

统一的 AI 模型聚合与分发网关，提供 OpenAI、Claude、Gemini 兼容接口与客户端接入指南。

码世界-TheWorld Codes

海量 AI 模型

连接全球算力，构建无限可能！

一个统一的 AI 模型聚合与分发网关。你可以用一个控制台管理 API Key、余额、用量和调用日志，并把常用客户端接到同一个接口地址。

三步开始

打开码世界控制台注册账号。
在控制台创建一个 API Key。
在客户端里填写接口地址和 Key。

Base URL: https://theworld.codes/v1
API Key:  在控制台创建

当前公告模型

平台公告中已列出的模型包括：

gpt-5.5
gpt-5.4
gpt-5.4-mini
gpt-5.3-codex
gpt-image-2

实际可用模型和价格以控制台显示为准。

第一次调用

bash

curl https://theworld.codes/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      { "role": "user", "content": "你好，介绍一下自己" }
    ]
  }'

注册账号

进入控制台后完成注册与登录，再进入密钥管理页进行创建即可开始接入。

创建 API Key

建议为不同项目单独创建 Key，方便在控制台里按用途区分与停用。

充值与用量

余额、消费记录和调用日志集中在同一个后台页面中查看，便于排查异常请求。

图像生成

如果客户端支持 OpenAI 兼容格式，可按同样的 Base URL 接入图像生成能力。

错误码说明

接入报错时优先检查 Base URL、Authorization 头和模型名称是否填写正确。

客户端配置

常见客户端包括 Cherry Studio、CC Switch、Lobe Chat、AionUI 与 OpenCat。在这些客户端中，通常需要统一填写接口地址（Base URL）和控制台创建的 API Key。

强烈推荐使用CC Switch

下载地址：https://www.ccswitch.io/zh/

支持直接导入：

也可以自行添加配置：

📌 中转API基础配置指南

接口地址 (Base URL)：统一填写 https://你的新中转域名.com/v1 （注意：原 helpapis.com 已废弃）。
API Key：填入你在中转控制台生成的令牌（格式通常为 sk-...）。

💡 核心中转知识：Base URL 的拼接规范

绝大多数客户端在设计时，会自动在填写的 Base URL 后面拼接具体端点（如 /chat/completions）。因此，在中转站配置时，接口地址必须以 /v1 结尾，且结尾通常不要加斜杠 /。

- 🟩 正确示例：https://api.yourdomain.com/v1

- 🟥 错误示例：https://api.yourdomain.com/v1/chat/completions（会导致重复拼接变成 /v1/chat/completions/chat/completions 从而报 404 错误）。

🖥️ 常见通用客户端官方文档

Cherry Studio 配置与使用 —— 支持全平台的桌面级大模型客户端。
CC Switch (CC Desktop Switch) 配置 —— 专为 Claude 桌面客户端及大模型通道切换设计的全能工具。
Lobe Chat 官方配置文档 —— 现代化、支持高颜值 UI 及插件系统的开源 AI 框架。
AionUI 官方页面 —— 针对 AI 智能体与自动化流设计的 UI 客户端。
OpenCat 配置指引 —— 针对 macOS/iOS 平台深度优化的原生大模型客户端。

🛠️ CLI 命令行与独立工具部署

Claude Code、Codex、Gemini CLI 这类专业级开发者工具建议按样板独立成部署页，避免版本说明与基础客户端的快速开始相混淆。这类工具通常需要在本地终端配置环境变量。

Claude Code 官方部署文档 —— Anthropic 官方推出的终端 AI 编码助手，中转配置需格外注意厂商兼容性。
Codex 部署与使用 —— 代码补全与终端效率工具。
Gemini CLI 官方文档 —— 将谷歌 Gemini 能力直接带入终端的命令行工具。

💡 中转进阶知识：终端环境变量配置

在使用上述 CLI 工具时，通常通过在终端执行命令来临时或永久挂载中转接口：

> # Linux / macOS 配置示例
> export OPENAI_BASE_URL="[https://api.yourdomain.com/v1](https://api.yourdomain.com/v1)"
> export OPENAI_API_KEY="sk-xxxxxx"
> 
> # Claude Code 专用（若中转站支持兼容通道）
> export ANTHROPIC_BASE_URL="[https://api.yourdomain.com/v1](https://api.yourdomain.com/v1)"
>

在线测试

文档中提供聊天测试与绘图测试入口。强烈建议您在首次使用、购买新套餐或中转迁移后，优先在此处进行验证。这不仅能确认账户余额与模型可用性，还能帮你排查是否是本地网络阻断了中转站。

常见问题与中转排查手册

如果遇到连接失败、模型不可用或余额异常，优先回看控制台日志和接口地址配置。

🎯 黄金排查法则

网络连接失败 / 连不上服务器

检查跨域 (CORS) 问题：如果您在 Web 端客户端（如自建的 Lobe Chat 网页版）使用中转，请确保中转站后端已开启跨域允许。
流式传输 (Stream) 异常：部分代理服务或 CDN（如开启了某些特殊缓存规则的 Cloudflare）可能会拦截 text/event-stream 导致打字机效果失效。请确保中转通道的 SSE（Server-Sent Events）未被拦截。

模型不可用 (Model Not Found / 404)

请检查你在客户端输入的模型名称（如 gpt-4o, claude-3-5-sonnet）是否与中转站控制台“可用模型列表”中的官方别名完全一致。大小写、横杠错误都会导致请求失败。

余额异常 / 401 Unauthorized

401 错误：代表 API Key 错误、已过期或已被封禁，请去控制台重新复制最新的令牌。
高倍率扣费疑问：不同模型在中转站通常设有不同的“扣费倍率（或权重）”，多模态模型（如带有图片输入）的输入 Token 计费与纯文本不同，请参考控制台的“模型费率说明页”。