Skip to main content
POST
提交原生分类、评分和真假判断
预览功能,需在目标环境开通 Jev。基础地址、令牌、可用模型和收费规则见 TypeSafe / Jev。

请求字段

每个问题用 type 指定类型,instructions 描述判断要求,criteria 定义选项或等级。 材料、说明和选项的嵌套 JSON 会按原生协议转发。超出上游支持的长度或格式时会返回错误,不会通过截断材料来伪装成功。

cURL

先按接入说明设置 ONEHUB_BASE_URL 和 ONEHUB_API_KEY:
成功响应包含 model、answers 和 usage。下面仅展示结构,判断值与用量不是固定结果:

JSON 图片与 Box 定位

图片与 Box 属于 Jev 1.14 的实验能力,需确认当前令牌选择的模型及上游渠道支持。支持 JSON assets 中的 PNG/JPEG Base64;multipart、图片 URL 下载和新版 SDK 文件上传方式不在本页支持范围内。上面的文本示例和下方两个已验证版本的 SDK 文本示例继续适用。 请求添加 TypeSafe-Danger-Zone-Images: true,并在 state 中引用 assets 的同一个唯一标识。渠道若已显式配置该图片开关,其配置优先于客户请求头;平台不会因出现 Box 自动开启其他实验功能。 以下示例只使用 Python 标准库,生成一张 512×512 白底图,中央红块覆盖 x/y 的 128 至 383 像素,再生成 JSON 请求文件,不在命令中展开长 Base64。ONEHUB_MODEL 可指定当前令牌已获授权且有 1.14 供给的模型;默认使用 jev-latest。
Box 回答结构如下,数值仅作说明,实际结果及用量以响应为准:
四边坐标均为 0–1 的相对位置;横向乘图片宽度、纵向乘图片高度即可画回原图,且应满足 left < right、top < bottom。confidence 也是 0–1 的数字,Box 不要求 Choice/Score 所需的 probabilities 或 legend。它始终给出一个矩形,目标不存在时也不能只凭框判断存在性;需要时像示例一样搭配 Noul。Box、Noul、Choice、Score 可以放在同一请求,仍按该请求的最终用量结算。

Python 官方客户端

以下示例基于已验证的 typesafe-sdk==0.7.4:

JavaScript 官方客户端

以下示例基于已验证的 @typesafe-ai/sdk@0.6.0,使用 Node.js 的 .mjs 文件运行:
这两个版本的模型列表返回值不同:Python 使用 client.models.list().models,JavaScript 的 client.models.list() 直接返回数组。调用时使用自己的平台令牌;不要把管理员配置的上游密钥放进客户应用。

读取答案与失败处理

answers 按问题名称返回答案。Choice 的 choice 对应提交的选项,Score 的 legend 解释等级;概率和置信度应按业务需要使用,不应直接视为判断必然正确的保证。 默认只按有效的最终输入用量收费,输出字段仍保留用于对账。错误、断开、重试和扣费的关系见失败时是否收费;查询消费记录时同时保留本次请求的模型名称和 X-Oneapi-Request-Id 响应头。

Authorizations

Authorization
string
header
required

使用平台签发的模型调用令牌,不填写上游密钥。

Body

application/json
model
string
required

当前令牌模型列表中的名称。

Minimum string length: 1
Example:

"jev-latest"

state
required

文本材料或其结构化 JSON 表达,不表示图像、音视频输入能力。

questions
object
required

键为问题名称,答案按相同名称返回。

Response

原生答案与有效最终用量。默认仅输入计费;响应版本不自动成为可调用模型。

model
string
required
Example:

"jev-1.13.0"

answers
object
required
usage
object
required