API 协议

OpenAI 兼容 API 调用指南

直接答案Chat Completions 与 Responses 使用不同的请求对象和返回对象。Chat 示例发送 messages;Responses 示例发送 input。不要只修改 URL 而保留另一种协议的请求体。

更新 · 审核信息

适用范围

Chat Completions 与 Responses 使用不同的请求对象和返回对象。Chat 示例发送 messages;Responses 示例发送 input。不要只修改 URL 而保留另一种协议的请求体。

选择接口与模型

模型广场展示精确型号、端点、用户组及价格。型号名称相似不代表参数和权限相同;上游官方资料用于了解能力边界,不能作为本站已上架或已计费的证明。完整示例与路由参考分别标注,请优先使用包含结果校验的接入示例。

账号与请求准备

在令牌页管理模型调用 Key,在个人设置管理账号访问凭据。不要把浏览器登录令牌、模型 Key 和个人访问令牌混用。示例从服务端环境变量读取占位凭据,不包含真实账号数据。请求参数必须按所选端点和渠道核实,示例值不是默认值。Base URL 为 https://api.openfox.vip。

结果与失败处理

同时检查 HTTP 状态与业务结果。文本必须有完整输出;图片需要真实解码;任务必须达到成功终态并拿到有效产物,任务 ID 本身不等于完成。查询可以有界重试,创建请求不要自动重试。超时时先保留请求编号,并到用量日志核对,避免重复创建或收费。

价格与后续维护

本文不写死费用、额度、保存期限或供应商折扣。请以模型广场当前价格及账号组权限为准;需要新价格或未上架型号时由管理员确认。接口示例与 OpenFox OpenAPI 定义同步生成,修改协议时同步检查请求字段、结果判定和失败路径。源码核对不代表上游业务验证,本次没有发起收费模型请求。

适用场景

  • 文本与结构化输出
  • 向量检索
  • 图像、语音和视频生成

API 协议

  • /v1/models
  • /v1/chat/completions
  • /v1/responses
  • /v1/embeddings

常见问题

从哪里确认模型和价格?

以本站模型广场当前型号、端点与用户组价格为准。

可以直接套用其他站点的接口吗?

不可以。必须核对本站路由、插件协议与鉴权要求。

源码核对是否等于业务测试通过?

不是。本次没有发起收费调用,上游可用性仍受渠道和权限影响。

官方来源

  1. OpenAI API Reference 官方
  2. OpenAI Developer Quickstart 官方
  3. Migrate to the Responses API 官方
  4. OpenAI Streaming Responses 官方
  5. OpenAI Function Calling 官方
  6. OpenAI Token Counting 官方
  7. OpenAI Production Best Practices 官方
  8. OpenAI Error Codes 官方
  9. OpenAI Rate Limits 官方
  10. OpenFox API 官方