API 协议

工具调用与结构化输出 API

直接答案工具调用返回的是工具执行意图,应用须验证参数并执行获准的操作,再把结果交回模型。JSON Schema 的支持程度随模型和渠道变化。当前文本示例不实现工具循环,不能把仅含工具调用的回复判为文本成功。

更新 · 审核信息

适用范围

工具调用返回的是工具执行意图,应用须验证参数并执行获准的操作,再把结果交回模型。JSON Schema 的支持程度随模型和渠道变化。当前文本示例不实现工具循环,不能把仅含工具调用的回复判为文本成功。

选择接口与模型

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

账号与请求准备

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

结果与失败处理

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

价格与后续维护

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

适用场景

  • 让模型安全调用业务函数
  • 生成符合 JSON Schema 的结构化数据
  • 构建可恢复、可审计的多步代理循环

API 协议

  • /v1/chat/completions
  • /v1/responses

常见问题

从哪里确认模型和价格?

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

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

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

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

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

官方来源

  1. OpenAI Function Calling Guide 官方
  2. OpenAI Structured Outputs Guide 官方
  3. OpenAI Responses API Reference 官方
  4. OpenFox API 官方