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

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

Excerpt

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

码世界-TheWorld Codes

海量 AI 模型

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

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

三步开始

1. 打开 码世界控制台 注册账号。
2. 在控制台创建一个 API Key。
3. 在客户端里填写接口地址和 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基础配置指南

1. 接口地址 (Base URL)：统一填写 https://你的新中转域名.com/v1 （注意：原 helpapis.com 已废弃）。
2. 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)"
> 

在线测试

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

常见问题与中转排查手册

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

🎯 黄金排查法则

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

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

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

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

1. 余额异常 / 401 Unauthorized

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