SuperAPI AI 工具集

venice-decisions

通用与其它

查看项目

更新于 10-16 07:17

技能介绍

用途:把一段状态(文本、JSON 对象或数组)针对一组带类型的问题求值,得到可直接用于代码分支的结构化答案,而不是自然语言文本。只有 TypeSafe 的 Jev(jev-latest,别名 jev-1-13-0 / typesafe-jev)一个模型。两条路由均标注 Beta,schema 与行为可能变动。

主要能力:支持三类问题。noul 返回 [0,1] 的是/否概率,无 confidence 字段;choice 从 criteria 映射中选一个选项,返回 choice、各选项 probabilities(和为 1)和 confidence;score 按有序 rubric 评分,返回概率加权得分、legend 和 confidence,索引从 0 起、以字符串为键。每个问题互相隔离、并行评估;问题的 id 不会传给模型,含义须全部写进 instructions。

使用方式:POST /api/v1/decisions,请求体含 model、state、questions(question_id → 问题对象),顶层与问题对象均为严格 schema。认证可用 Authorization: Bearer $VENICE_API_KEY,或用于 x402 的 SIGN-IN-WITH-X;无凭据会得到 402 x402 发现响应。响应含 model(恒为 jev-latest)、answers、usage。x402 余额请轮询 GET /x402/balance/{walletAddress}。/api/v1/systemone 行为相同,便于 TypeSafe SDK 通过 base-URL 替换使用:TYPESAFE_BASE_URL=https://api.venice.ai/api。模型列表用 GET /api/v1/models?type=decision。

限制与注意:非聊天路由,没有 messages、temperature、max_tokens、流式或工具调用,未知字段会 400。token 预算由 TypeSafe 上游执行(maxStateTokens 32000、maxTotalTokens 64000),超限会先通过 Venice 校验再在上游失败;通用 JSON 体上限 35 MB。定价以 model_spec 为准(当前输入 $0.042/1M token、输出 $0;价格与限额可能变化)。密钥 modelPrivacy 为 PRIVATE_ONLY 或 PRIVATE_TEXT 时会被 403 拒绝,状态会发送给 TypeSafe,不适用于要求 Venice 私有推理的数据。概率在不同请求间会波动,confidence 不保证正确性,阈值需自行标定。遇到 429 请遵循 Retry-After 并加抖动退避。