指南

本站 API 端点与能力矩阵

直接答案按实际操作选择接口,而不是从模型名猜协议。文本可使用 Chat、Responses、Messages 或 Gemini;图片使用生成或编辑端点;异步结果通过任务查询读取。下表只列已核对的示例入口。

更新 · 审核信息

适用范围

按实际操作选择接口,而不是从模型名猜协议。文本可使用 Chat、Responses、Messages 或 Gemini;图片使用生成或编辑端点;异步结果通过任务查询读取。下表只列已核对的示例入口。

选择接口与模型

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

账号与请求准备

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

结果与失败处理

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

价格与后续维护

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

接口速查

方法路径说明
GET/v1/modelsmodels
POST/v1/chat/completionschat
POST/v1/responsesresponses
POST/v1/images/generationsimages
POST/v1/messagesmessages
POST/v1beta/models/{model}:generateContentgemini
POST/v1/embeddingsembeddings
POST/v1/rerankrerank
GET/v1/tasks/{task_id}task
GET/v1/tasks/{task_id}/artifactsartifacts

适用场景

  • 文本、媒体、检索接口选路
  • 识别未实现接口与渠道边界

API 协议

  • /v1/models
  • /v1/chat/completions
  • /v1/responses
  • /v1/messages
  • /v1beta/models/{model}:generateContent
  • /v1/images/generations
  • /v1/images/edits
  • /v1/embeddings
  • /v1/rerank
  • /v1/tasks/{task_id}

常见问题

从哪里确认模型和价格?

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

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

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

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

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

/v1/files 可以使用吗?

目录中的路由参考只证明源码入口存在;使用前须核对渠道支持、文件协议与返回结果。

官方来源

  1. OpenAI API Reference 官方
  2. Claude Messages API 官方
  3. Gemini API Reference 官方
  4. OpenFox API 官方