Skip to main content
POST
作出结构化决策
当应用需要代码可直接使用的结构化答案时,请使用 POST /v1/decisions。受支持的模型包括 TypeSafe Jev 1.13 (typesafe/jev-1.13.0)、Together Tev1 4B Experimental (together/tev1-4b-experimental) 和 Respan Span-01(respan/span-01:free 和 respan/span-01)。 请求包含:
  • state:包含待评估信息的字符串、对象或数组。
  • questions:具名问题的映射。每个问题将 type 设置为 noul、choice 或 score,并包含 instructions;支持的类型取决于所选模型。
  • model:Phaseo 模型 ID。使用 typesafe/jev-1.13.0 指定 Jev 1.13,或使用 typesafe/jev-latest 跟随最新 Jev 版本。
Liquid D1(liquid-ai/d1:free,也可使用 liquid-ai/d1)和 Perplexity Decider 27B (perplexity/decider-27b) 支持全部三种问题类型。D1 在实验性早期访问期间免费。Decider 每百万输入 token 收费 0.04 美元,包括图像 token;输出 token 免费。使用 Decider 前,请在 Phaseo 中添加 Perplexity 提供商凭证。其图像状态使用 PNG、JPEG 或 WebP 的 base64 数据 URL;不支持远程图像 URL。每个选择问题最多接受 255 个选项,每个评分问题最多接受 10 个等级。调用任一模型前请检查其可用性。 对于 Respan Span-01,state 必须是一个会话片段,包含先前消息的 input 数组和一条助手的 output 消息。Span-01 仅支持 noul 问题。noul 答案表示该行为存在的概率;probabilities 还包含不存在和不可观察的概率。
respan/span-01:free 是有每日限额的免费 Lite 模型;Phaseo 将其映射为 Respan 的 API 模型 ID span-01-free。respan/span-01 映射为 Respan 的 API 模型 ID span-01-pro,由 Respan 按每百万输入 token 0.02 美元计费;输出 token 免费。Span-01 处于早期访问阶段,因此 Respan 必须为您的组织启用访问权限。调用这些模型前,请将 Respan API 密钥添加为 Phaseo 中的 Respan 提供商凭证。 答案使用与 questions 相同的键。choice 答案包含所选选项、概率和置信度;noul 答案包含 0–1 的概率;score 答案包含概率加权分数、图例、概率和置信度。 对于 Respan 示例,响应如下:
Jev 支持在同一请求中混合全部三种问题类型;Span-01 仅支持 noul 问题。请参阅快速开始,获取可直接复制的 cURL、JavaScript、TypeScript SDK 和 Python SDK 示例。Jev 1.13 按每百万输入 token 0.042 美元计费;输出 token 免费。 有关上游问题语义,请参阅 TypeSafe 的 API 参考。

使用Clef进行图像决策

cloudflare/clef和cloudflare/clef-flash通过Cloudflare Workers AI支持全部三种问题类型和嵌入图像。两者的上下文窗口均为65,536个令牌。输入价格为每百万令牌Clef 0.24美元、Clef Flash 0.09美元。
也可以在images中提供data:image/png;base64,...字符串。Clef最多接受四张PNG、JPEG或WebP图像,每张最多4 MiB和1,600万像素,解码后图像数据总量最多8 MiB,请求体最多13 MiB。不支持远程URL。Cloudflare会验证图像格式和尺寸。不支持图像的模型会拒绝图像请求。 Clef最多接受64个问题,ID最多100个字母、数字、下划线、点或连字符。选择题需要2–255个选项,评分题需要2–10个等级。请参阅Cloudflare的Clef文档。

授权

Authorization
string
header
必填

Bearer 令牌身份验证

请求体

application/json
model
string
默认值:typesafe/jev-1.13.0
必填

Phaseo 的规范模型 ID 或提供商模型别名。

state
必填

由模型评估的结构化状态。

questions
object
必填
images
(string | object)[]

用于具备视觉能力的决策模型的嵌入图像。Clef接受PNG、JPEG或WebP,不支持远程URL。每张图像最多4 MiB和1,600万像素,解码后数据总量最多8 MiB,每个请求体最多13 MiB。

Maximum array length: 4
Pattern: ^[Dd][Aa][Tt][Aa]:image/(png|jpeg|webp);base64,[A-Za-z0-9+/]+={0,2}$
meta
boolean
默认值:false
echo_upstream_request
boolean
debug
object

网关调试控制项。这些标志绝不会转发给提供商。

provider
object

用于网关选择的提供商路由偏好设置。

routing
object

用于网关选择的提供商路由偏好设置。

metadata
object

响应

200 - application/json

结构化决策响应

model
string
answers
object
usage
object
request_id
string | null
meta
object
最后修改于 2026年10月2日