常见问题
常见问题
docs.ofapp.cn 常见问题中心回答 OfApp.cn、API Key、Base URL、Codex、GPT Image、Claude 兼容、报错排查和模型可用性。
这里整理使用 docs.ofapp.cn 和 OfApp.cn 时最常见的问题。读者可能只是想聊天、写作、读文件、生图，也可能正在把 API 接进 SDK、Codex、Claude 兼容客户端或自己的项目。FAQ 的目标是先给出可执行的下一步，再把涉及模型、价格、额度和能力的可变信息交回控制台或官方文档确认。
| 项目 | 说明 |
|---|---|
| 阅读时间 | 约 5 分钟 |
| 更新时间 | 2026-07-03 |
| 适合读者 | AI 初学者、开发者、办公用户、内容创作者、正在排查 API 问题的人 |
| 你会获得 | 入口选择、Key 和 Base URL 边界、常见报错排查顺序、相关教程链接 |
| 问题类型 | 先看什么 | 继续阅读 |
|---|---|---|
| 想直接使用 AI | OfApp.cn 或天才游乐场 | AI 工作流 |
| 获取 Key 和配置入口 | 快速开始 | 如何获取 API Key |
| Base URL 不确定 | 如何配置 Base URL | OpenAI 兼容 API 快速开始 |
| 接入 SDK 或脚本 | 开发者中心 | Cookbook |
| 让 Codex 做项目任务 | Codex 教程 | Codex CLI 接入 OfApp.cn |
| 图片生成 | GPT Image | GPT Image 接入教程 |
| Claude 兼容客户端 | Claude 兼容生态 | Messages 兼容接口说明 |
| API 报错 | API 错误排查中心 | 常见错误排查 |
FAQ 路线图
Section titled “FAQ 路线图”提问前准备什么
Section titled “提问前准备什么”很多 API、客户端和 Codex 问题看起来像“模型不能用”，实际原因可能在 Key、Base URL、路径、客户端配置、模型名来源或网络层。提问前先整理下面几项，可以让排查从猜测变成定位。
| 信息 | 应该准备什么 | 不要提供什么 |
|---|---|---|
| 使用入口 | 天才游乐场、SDK、Codex、Claude 兼容客户端、浏览器工具或自建后端 | 模糊描述“我这里不能用” |
| 请求地址 | 脱敏后的 Base URL、最终端点路径、是否出现重复版本路径 | 完整带 Key 的请求命令 |
| Key 状态 | 是否从控制台创建、是否已放入环境变量、是否换过终端窗口 | 完整 API Key |
| 模型来源 | 模型名是否来自当前控制台或官方文档 | 旧教程里看到的固定模型名 |
| 报错证据 | 状态码、响应摘要、请求时间、客户端名称和最小复现步骤 | 带隐私内容的完整日志 |
| 已尝试动作 | 是否跑过最小请求，是否换过网络，是否检查过 .env 加载 |
同时修改多个变量后的结果 |
如果你要向别人求助，建议只贴脱敏后的最小复现。真实 Key、文件全文、用户数据、客户信息和内部日志都应该留在本地或安全系统里。
隐私与安全边界
Section titled “隐私与安全边界”FAQ 页面经常被用来排查问题，但排查不等于公开所有信息。下面这些内容不适合贴到公开页面、截图、Issue 或聊天记录里：完整 API Key、公司内部文档、客户名单、财务数据、合同原文、数据库导出、完整请求头、包含隐私的日志和没有脱敏的文件内容。
更稳的做法是只保留定位问题所需的最小信息：状态码、端点路径、是否使用流式、客户端名称、脱敏后的环境变量名、最小请求片段和已经尝试过的排查步骤。这样既能让别人理解问题，也能降低泄露风险。
OfApp.cn 是什么？
Section titled “OfApp.cn 是什么？”OfApp.cn 可以作为 AI API 入口和网页使用入口。普通用户可以从天才游乐场开始聊天、写作、读文件和生图；开发者可以把 Key 与 Base URL 配置到 SDK、Codex、兼容客户端或自己的项目里。具体模型、能力、额度和价格请以 OfApp.cn 控制台或官方文档为准。
普通用户应该先从哪里开始？
Section titled “普通用户应该先从哪里开始？”如果你只是想体验聊天、写作、读文件或生图，先打开 OfApp.cn 或天才游乐场，不必先研究接口参数。等你需要接入 Codex、客户端、SDK 或自动化脚本时，再回到 快速开始 配置 Key 和 Base URL。
API Key 从哪里获取？
Section titled “API Key 从哪里获取？”API Key 从 OfApp.cn 控制台获取。本站示例统一使用 sk-xxxx 作为假值，不代表真实 Key。真实 Key 不应该出现在公开网页、截图、聊天记录、README 或前端代码里。
API Key 可以写进前端代码吗？
Section titled “API Key 可以写进前端代码吗？”不建议。OpenAI 官方文档也把 API Key 视为秘密，建议从服务端环境变量或密钥管理服务加载。前端应用应该请求自己的后端接口，由后端读取 Key 并转发请求。
Base URL 应该怎么写？
Section titled “Base URL 应该怎么写？”本站示例常用 https://api.ofapp.cn/v1。如果某个客户端会自动追加版本路径，可能需要填写不带版本路径的入口；如果工具要求完整版本路径，则按工具说明填写。遇到 404 或 /v1/v1 这类路径问题时，先看 如何配置 Base URL。
OpenAI 兼容接口等于完全兼容吗？
Section titled “OpenAI 兼容接口等于完全兼容吗？”不等于。兼容通常表示请求形态、SDK 使用方式或部分端点接近 OpenAI API，但模型、参数、错误格式、端点开放范围和能力边界仍可能不同。上线前应以当前服务商文档和最小请求验证。
Codex CLI 如何接入 OfApp.cn？
Section titled “Codex CLI 如何接入 OfApp.cn？”Codex CLI 接入时要确认 API Key、Base URL、模型来源和本地配置文件。更稳的做法是按 Codex CLI 接入 OfApp.cn 跑通最小验证，再让 Codex 处理真实项目任务。
GPT Image API 一定可用吗？
Section titled “GPT Image API 一定可用吗？”本站不对具体模型、端点或图片能力做静态承诺。请以 OfApp.cn 控制台或官方文档展示为准，并用 GPT Image 接入教程 或 API 生图示例 先跑最小请求。
Claude 兼容接口等于官方 Claude API 吗？
Section titled “Claude 兼容接口等于官方 Claude API 吗？”不等于。Claude 兼容通常指请求结构、Messages 格式或客户端生态适配接近，但可用模型、参数、错误格式和能力边界仍要以当前文档和实际测试为准。可以从 Claude Messages 兼容接口说明 开始。
报错时应该先查什么？
Section titled “报错时应该先查什么？”先查四件事：API Key 是否正确加载、Base URL 是否拼接正确、模型名是否来自控制台、最小请求是否能独立复现。不要同时修改 SDK、Prompt、模型和业务代码。状态码问题可以进入 API 错误排查中心。
模型、价格、额度和能力以哪里为准？
Section titled “模型、价格、额度和能力以哪里为准？”以 OfApp.cn 控制台或官方文档为准。知识库页面会尽量提供稳定方法、排查路径和示例结构，但不会把会变化的模型、价格、额度或能力写成长期承诺。
我只想写文章、做 PPT 或总结 PDF，要看 API 教程吗？
Section titled “我只想写文章、做 PPT 或总结 PDF，要看 API 教程吗？”不一定。普通办公和创作任务可以先看 AI 办公 或 AI 工作流。只有当你要把流程自动化、批量化或接进自己的工具时，再进入 API、SDK 和 Cookbook 页面。
| 你要做什么 | 推荐入口 |
|---|---|
| 快速配置 Key 和 Base URL | OfApp.cn 快速开始 |
| 跑通最小 API 请求 | OpenAI-compatible API 快速开始 |
| 选择可复制代码示例 | Cookbook |
| 接入 SDK | 如何用 OpenAI SDK 接入 |
| 处理 Codex 项目任务 | Codex 教程 |
| 处理图片生成 | GPT Image |
| 接 Claude 兼容生态 | Claude 兼容生态 |
| 排查错误 | API 错误排查中心 |
- 如何获取 OfApp.cn API Key：创建、保存和验证 Key。
- 如何配置 Base URL：避免路径漏写或重复拼接。
- OpenAI-compatible API 快速开始：跑通最小请求。
- Codex CLI 接入 OfApp.cn：配置 Codex 的 Key、Base URL 和本地验证。
- GPT Image 接入教程：图片生成 API 的最小路径。
- Claude Messages 兼容接口说明：理解 Messages 格式和兼容边界。
- API 错误排查中心：按状态码定位问题。
FAQ 页的核心是把问题拆清楚：普通用户先找网页入口，开发者先验证 Key、Base URL 和最小请求，涉及模型、价格、额度和能力的内容回到 OfApp.cn 控制台或官方文档。遇到报错时，不要猜；先收集脱敏日志和最小复现，再按错误中心逐层排查。