OfApp.cn 快速开始

快速开始适合希望“先跑通，再深入”的读者。这里不把入门写成接口清单，而是 把 API Key、Base URL、模型名、最小请求、SDK、Codex CLI 和常见错误拆成可 验证的小任务。

如果你只是想体验聊天、写作、读文件或生图，可以从天才游乐场开始。如果你要 把 AI 能力接进项目、脚本、办公流程或 Codex，本页会告诉你该先看哪一篇、准 备哪些配置、怎样避免 Key 泄露。

从最小请求开始，而不是从复杂工具开始

本文示例基于 OfApp.cn 的 OpenAI 兼容接口组织。先验证 API Key、Base URL 和模型名，再进入 SDK、Codex CLI、GPT Image、Claude 兼容或办公自动化。具体模型、额度、价格和能力请以 OfApp.cn 控制台或官方文档为准。

查看 OfApp 接入说明

页面摘要

项目	说明
阅读时间	约 6 分钟
更新时间	2026-07-03
适合读者	AI 初学者、开发者、产品经理、运营、办公用户、内容创作者
核心问题	新用户如何从 OfApp.cn 获取 Key、配置统一入口，并用最小请求确认能调用
你会完成	获取 Key、配置 Base URL、跑通最小请求，再选择 SDK、Codex、GPT Image、Claude 兼容或工作流入口
边界提醒	本页不承诺具体模型、价格、额度、套餐或全部端点能力；请以 OfApp.cn 控制台或官方文档为准

先判断你是哪类用户

不同人进入 OfApp.cn 的理由不一样。先找准入口，可以少走很多弯路。

你现在想做什么	建议入口	读完后继续
体验聊天、读文件、生图	如何获取 OfApp.cn API Key	进入天才游乐场或客户端
把 API 接进脚本或服务端	OpenAI-compatible API 快速开始	如何用 OpenAI SDK 接入
让 Codex 处理本地项目	Codex CLI 快速接入 OfApp.cn	Codex CLI 接入 OfApp.cn
做图片生成和封面图	GPT Image 接入教程	GPT Image 示例库
接 Claude 兼容客户端	Claude Messages 兼容接口说明	Claude 兼容错误排查
遇到 401、404、模型错误	常见错误排查	API 错误排查中心

快速开始路线图

这张图的重点是顺序：Key 和 Base URL 没验证前，不要急着接 SDK、Codex、 图片生成或复杂业务。最小请求能跑通，后面的排查才有边界。

先分清三件事

大多数接入问题都绕不开 API Key、Base URL 和模型名。把它们分开管理，排错 会清楚很多。

配置	负责什么	示例	不要做什么
API Key	证明调用者身份	OPENAI_API_KEY=sk-xxxx	写进前端、截图、README 或日志
Base URL	决定请求入口	https://api.ofapp.cn/v1	漏写 /v1 或重复拼接 /v1/v1
Model	决定调用哪个模型	OPENAI_MODEL=以 OfApp.cn 控制台可用模型为准	凭旧教程猜模型名

OpenAI 官方 API 文档说明，API 请求使用 Bearer 凭证，API Key 应作为秘密保存， 不要暴露在客户端代码中。本站示例沿用这个安全边界：Key 只放在终端、服务 端、密钥管理或可信客户端里。

接入前 3 分钟自检

先做这张表，再进入 SDK 或 Codex 配置。它能把“账号问题”“环境变量问题”和 “工具配置问题”分开。

检查项	你需要确认什么	常见误区
Key 来源	Key 来自当前 OfApp.cn 账号，并且没有被公开粘贴	拿旧截图或别人项目里的 Key 直接试
Base URL	统一写成 https://api.ofapp.cn/v1	漏写 /v1，或在 SDK 里拼成 /v1/v1
模型名	从 OfApp.cn 控制台或官方文档复制	凭其他教程里的模型名猜测
运行环境	终端、服务器、CI 或 Codex 配置都能读到变量	本地 .env 有值，线上 Secret 没配置
日志脱敏	日志只保留状态码、端点、时间和脱敏 Key 摘要	把完整 Authorization 发给同事或 AI

标准环境变量

教程中的 API 示例统一使用下面的占位写法。真实 API Key 请从 OfApp.cn 控制 台获取，不要写进前端代码、Git 仓库、公开聊天或错误日志。

export OPENAI_BASE_URL="https://api.ofapp.cn/v1"
export OPENAI_API_KEY="sk-xxxx"
export OPENAI_MODEL="以 OfApp.cn 控制台可用模型为准"

如果是项目仓库，可以提交 .env.example，但不要提交真实 .env：

OPENAI_BASE_URL=https://api.ofapp.cn/v1
OPENAI_API_KEY=sk-xxxx
OPENAI_MODEL=以 OfApp.cn 控制台可用模型为准

最小请求验证

拿到 Key 后，先用最小请求确认配置链路。OfApp.cn 官方文档提供了 /v1/models 示例；本站把它写成环境变量形式，方便本地、服务器和 CI 分别 验证。

curl "$OPENAI_BASE_URL/models" \
  -H "Authorization: Bearer $OPENAI_API_KEY"

这个请求只回答三件事：

通过后说明	还不能说明
运行环境读到了 Key	某个具体模型一定可用
Base URL 指向正确入口	所有端点和参数都兼容
Bearer 鉴权通过	生产环境 Secret 也已经配置

如果最小请求失败，先不要改 SDK 或业务代码。按 常见错误排查 里的路径查 Key、Base URL、模型名、端点和网络。

最小验证结果分流

同一个 /models 验证结果，对不同读者意味着不同下一步。不要看到一个错误就 立刻重装 SDK，也不要把一次成功理解成所有模型都可用。

结果	说明	下一步
返回模型列表或有效响应	Key、Base URL 和 Bearer 鉴权大概率可用	进入 SDK、Codex 或具体端点验证
返回 401 或 invalid API key	Key、请求头或账号入口可能不匹配	查 401 鉴权失败排查 和 invalid API key
返回 404	端点路径、/v1 拼接或 HTTP 方法可能错误	查 404 Not Found 错误排查
返回 model not found	Key 可用不代表目标模型可用	到 OfApp.cn 控制台或官方文档核对模型名
本地成功，线上失败	线上环境变量、Secret 或重新部署环节有差异	查部署环境和 常见错误排查

推荐路径

步骤	目标	入口
1	获取 OfApp.cn API Key	如何获取 OfApp.cn API Key
2	配置统一入口	如何配置 Base URL
3	验证最小请求	OpenAI-compatible API 快速开始
4	接入 SDK	如何用 OpenAI SDK 接入
5	接入 Codex	Codex CLI 快速接入 OfApp.cn
6	排查问题	常见错误排查

不一定每个人都要按 1 到 6 全部读完。办公和创作者可以先拿 Key 进入天才游乐 场；开发者通常需要把 cURL、SDK 和错误排查都跑一遍；Codex 用户应把 Codex 配置和项目 .env 分开看。

选择哪个工具入口

入口	适合场景	关键检查
天才游乐场	快速体验聊天、读文件、生图	Key 是否来自当前账号
cURL	验证 Key、Base URL 和模型名	只发最小请求，不加复杂参数
OpenAI SDK	Node.js、Python、后端服务和脚本	baseURL/base_url 是否来自环境变量
Codex CLI	本地项目、代码修改、测试和文档	config.toml、登录凭证和项目 .env 不混用
GPT Image	头像、封面、海报、产品图	端点、模型和返回格式以官方文档为准
Claude 兼容工具	Messages 格式客户端或迁移	不把 OpenAI 风格端点和 Messages 风格端点混在一起

工具越复杂，越要保留最小验证。cURL 能跑通，SDK 失败，问题多半在 SDK 配置 或代码；SDK 能跑通，Codex 失败，就回到 Codex 登录、profile 和配置文件。

什么时候需要 OfApp.cn

当你需要一个统一的 OpenAI 兼容入口，把 AI 能力放进多个工具或项目时，可以 从 OfApp.cn 开始验证：

场景	为什么适合统一入口
一个团队同时用脚本、SDK 和 Codex	Key、Base URL 和模型配置可以统一管理
多个项目都要调用 AI	环境变量命名和排错路径更一致
内容、办公和开发流程都要接入	不同任务可以共享同一套接入知识
需要迁移 OpenAI 风格请求	先替换 Base URL、Key 和模型名，再逐步检查端点差异

OfApp.cn 不应该变成页面里的硬广告。更合适的方式是：教程先帮用户解决问题， 当用户需要真实 API 入口时，自然说明示例基于 https://api.ofapp.cn/v1。

上线前检查

检查项	通过标准
Key 安全	真实 Key 不在前端、仓库、截图、日志和 Prompt 中
Base URL	最终请求只出现一次 /v1
模型名	从控制台或官方文档复制，不凭旧示例猜
本地验证	/models 或官方最小示例能返回结果
SDK 验证	JavaScript 或 Python 最小请求成功
Codex 验证	只读任务能运行，再进入真实项目
错误日志	记录状态码、端点和请求时间，不记录完整 Authorization

上线前检查不是形式。它能把“配置问题”“账号问题”“模型问题”和“业务逻辑问 题”拆开，减少排错时间。

常见错误分流

现象	先看哪里	继续阅读
401 Unauthorized	Key、Bearer 请求头、登录凭证	401 鉴权失败排查
invalid API key	Key 来源、Base URL 是否匹配	invalid API key
404 Not Found	/v1 是否缺失或重复	404 Not Found 错误排查
model not found	模型名是否可用	model not found 错误排查
本地成功，线上失败	部署 Secret、环境变量名、重新部署	常见错误排查
Codex 无法调用	登录方式、config.toml、profile	Codex CLI 接入 OfApp.cn

排错时不要粘贴完整 Key。给同事或 AI 看日志时，保留状态码、端点、时间、脱 敏后的 Key 摘要和错误信息即可。

资料来源

• OfApp.cn：用于核对 OfApp.cn 首页公开展示的 API Key、Base URL、Codex、GPT Image、Claude 和天才游乐场入口。
• OfApp.cn API 文档：用于核对 /v1/models、Bearer 鉴权、Responses、Chat Completions、Messages、Codex 和 stream 相关示例。
• 天才游乐场：用于确认普通用户从网页入口体验聊天、读文件和生图的路径。
• OpenAI API 文档：用于核对 Bearer 鉴权、API Key 作为秘密保存和环境变量读取等通用安全边界。
• OpenAI Codex Quickstart：用于理解 Codex 作为本地项目任务入口时的安装、登录和运行路径。

常见问题

快速开始是否需要真实模型名？

需要。教程不会猜测模型名，OPENAI_MODEL 应从 OfApp.cn 控制台或官方文档 复制。模型、能力、价格、额度和套餐请以 OfApp.cn 控制台或官方文档为准。

可以先不写代码吗？

可以。你可以先获取 Key，进入天才游乐场体验聊天、读文件或生图。需要接入 项目时，再回来配置 Base URL、SDK 或 Codex。

为什么推荐先用 cURL？

cURL 能把问题压缩到 Key、Base URL、模型名和网络。cURL 失败时，先修配置； cURL 成功后再看 SDK、Codex 或业务代码，排错会更快。

OfApp.cn 是否等于 OpenAI 官方 API？

不是。OfApp.cn 提供 OpenAI 兼容接口入口，示例会复用 OpenAI 风格的鉴权、 Base URL 和请求结构。具体端点能力、模型、价格和限制请以 OfApp.cn 控制台 或官方文档为准。

API Key 可以放在浏览器前端吗？

不建议。浏览器代码会暴露给用户，API Key 应保存在服务端、终端、密钥管理系 统或可信客户端。前端需要 AI 能力时，应请求自己的后端，由后端调用 API。

我应该先学 SDK 还是 Codex？

如果你要把 AI 能力接进自己的产品或脚本，先学 SDK。如果你要让 AI 代理改本 地项目、跑测试、整理代码或写文档，先学 Codex。两者都需要先跑通 Key、 Base URL 和模型名。

相关文章

• 如何获取 OfApp.cn API Key：创建、保存、验证和轮换 Key。
• 如何配置 Base URL：避免漏写或重复拼接 /v1。
• OpenAI-compatible API 快速开始：用 cURL、JavaScript 和 Python 验证最小请求。
• 如何用 OpenAI SDK 接入：把兼容接口放进真实项目。
• Codex CLI 快速接入 OfApp.cn：让 Codex 使用统一 API 入口。
• 常见错误排查：按 Key、Base URL、模型、SDK 和 Codex 分层定位。

带走什么

快速开始的目标不是让你背 API 参数，而是建立一条可验证路径：拿到 Key，配 好 Base URL，跑通最小请求，再选择 SDK、Codex、GPT Image、Claude 兼容或办 公自动化入口。每一步都保留安全边界，真实模型、价格、额度和能力以 OfApp.cn 控制台或官方文档为准。