什么是 OpenAI 兼容 API

OpenAI 兼容 API 指的是沿用常见的请求结构、鉴权方式和 SDK 调用习惯，通过更换 Base URL、API Key 与模型 ID 接入不同模型。对于已经使用 OpenAI SDK 的项目，这种方式可以减少多供应商接入时的改造量。

ApiHub 的公开 Base URL 为 https://video.gqaiapp.com/v1。模型可用性、模型 ID 和价格应以站内模型目录为准。

接入前需要准备什么

在 ApiHub 控制台创建并妥善保存 API Key

从模型目录确认当前可用的模型 ID

在服务端环境变量中保存密钥，不要写入前端代码或公开仓库

为请求设置合理的超时、重试次数和日志字段

典型请求需要包含 Authorization: Bearer YOUR_API_KEY 与 Content-Type: application/json。使用 Chat Completions 或 Responses API 时，应根据文档选择对应路径和请求体。

Base URL: https://video.gqaiapp.com/v1

如果现有项目使用 OpenAI SDK，通常只需要替换 baseURL、apiKey 与 model。不同模型对多模态输入、工具调用、上下文长度和推理参数的支持并不完全相同，不能假设所有参数都可跨模型直接复用。

将 API Key 放在服务端环境变量或密钥管理服务中

记录请求 ID、模型 ID、耗时与业务任务 ID

只对网络错误、限流和可重试的上游错误执行有限重试

对超时请求做好状态确认，避免客户端重复提交造成重复任务

根据业务质量要求设置模型回退，不要静默切换到能力差异过大的模型

通用对话与内容处理：查看 GPT、Claude、Gemini、Grok 等当前可用型号

编程与代理任务：查看 Codex 及代码能力相关模型

图像任务：查看模型目录中的图像生成或多模态模型

视频任务：使用独立的 AI 视频 API 工作流，不要把异步视频任务当作普通文本请求处理

是否可以直接复用 OpenAI SDK？

多数标准文本请求可以沿用 OpenAI 兼容 SDK 的调用方式，但必须按 ApiHub 文档配置 Base URL，并核对目标模型支持的参数。

切换模型只需要改模型 ID 吗？

基础文本请求通常如此。涉及工具调用、多模态、推理参数或超长上下文时，还应核对模型能力和输入格式。

失败请求如何处理？

客户端应保留请求日志并避免无限重试。站内计费与失败处理规则以产品页面和控制台记录为准。