跳转到主要内容
POST
作出结构化决策
此端点处于 Beta 阶段。 将 input 和按顺序排列的 questions 数组发送到 POST /v1/decisions,即可按相同顺序为每个问题获得一个带类型的回答及其概率。

作出决策

此请求对每种类型各提一个问题。它需要一个 Phaseo API 密钥和一条可用的 openai/gpt-6-luna 路由。
响应(数值仅作示意):

编写问题

input 是一个字符串,或一个 user 消息数组,其中 content 是字符串,或由 input_text、input_image、input_audio 和 input_video 部分组成的列表。name 是可选的;回答保持请求中的顺序,包括未命名的问题和重复的名称。 每个请求最多包含 128 个问题,但 google/gemini-decision-1 最多可接受 1,000 个,parallel/decisions-fast 最多可接受 100 个,Clef 最多可接受 64 个。超出模型上限的请求会返回 400。 布尔类型的选项值会以布尔值返回。模型拒绝回答某个问题时,会为该问题返回 type: "refusal"。各模型支持哪些类型,见选择模型。 图像以 data URL 的形式放在 input_image 部分中。托管的 HTTPS 图像 URL 仅适用于 Base Labs 模型(baselabs/elephant-1、baselabs/mammoth-1 和 baselabs/joey-1),并且必须位于 Amazon S3、Google Cloud Storage 或 Azure Blob Storage 上。一个请求最多携带 128 张图像,Luna 可以全部接受;其他提供商的上限更低。显式的图像 detail 和 safety_identifier 需要 OpenAI 路由。

使用旧的 state 格式

带有 state 和命名问题映射的请求仍然可用,并返回以相同名称为键的回答。Together Tev(together/tev1-4b-experimental)需要这种格式,因为它返回不带概率的标签,并且只回答 choice 问题。Respan Span-01 也使用这种格式。不要混用两种格式:input 与 state 或 images 同时出现会返回 400。
  • state:一个字符串、对象或数组,包含要评估的信息。
  • questions:最多 128 个命名问题,上限更高的模型可接受更多。每个问题将 type 设为 noul(是/否)、choice 或 score,并提供 instructions。选择题的 criteria 是选项到描述的映射;评分题的 criteria 是至少包含两个级别描述的数组。
  • locate 问题只使用 instructions,并且需要不含 images 的字符串 state;参见 Perplexity Decider。
  • images:最多四张 PNG、JPEG 或 WebP 图像,形式为 data: URL 或 { "content_type", "base64" } 对象。
  • model:省略时默认为 typesafe/jev-1.13.0。
回答使用与 questions 相同的键。choice 回答包含所选选项、概率和置信度;noul 回答包含一个 0–1 的概率;score 回答包含按概率加权的分数、图例、概率和置信度。

选择模型

调用以下任何模型之前,请先检查模型可用性。 所有列出价格的模型,输出 token 均免费。

TypeSafe Jev

使用 typesafe/jev-1.13.0 调用 Jev 1.13,或使用 typesafe/jev-latest 跟随最新的 Jev 版本。上游问题语义请参阅 TypeSafe 的 API 参考。 在支持的 TypeSafe 路由上,Jev 1.13 和 1.14 可以通过 input_image 或旧的 images 字段接受内联 PNG 或 JPEG 图像。Phaseo 会构建 TypeSafe 的图像资源并自动启用图像支持。图像必须符合 TypeSafe 的图像限制:每张最多 16 MiB,每条边 256 到 1568 像素,总像素至少 78,400。TypeSafe 会校验尺寸和编码,并且不会缩放被拒绝的图像。映射后的上游 JSON 正文上限为 32 MiB。图像 token 按正常输入价格计费。 box(在 Jev 1.14 等支持的路由上)需要一张图像,不接受 criteria,并返回一个边界框和置信度。边界值范围为 0 到 1,从左上角开始测量。Box 总是返回一个矩形,因此当目标可能不存在时,请搭配一个 predicate 存在性问题。使用旧的 images 字段时,引用 images[0];使用有序输入时,引用第一张图像或 [Image 0]。请参阅 Box 契约。 将 provider_options.typesafe.long_context 设为 true,可将每个请求和每个问题的上下文上限提高到 262k token,而默认值为每个请求 64k、每个问题 32k。长上下文每 token 的价格相同。图像、Box 和长上下文都是上游的实验性能力。

Cloudflare Clef 和 Clef Flash

cloudflare/clef 和 cloudflare/clef-flash 运行在 Cloudflare Workers AI 上。Clef 的上下文窗口为 65,536 token,Clef Flash 为 24,576 token。
images 也接受 data:image/png;base64,... 字符串。Clef 最多接受四张 PNG、JPEG 或 WebP 图像,每张最多 4 MiB、1600 万像素,解码后的图像数据合计最多 8 MiB,请求正文最多 13 MiB。不支持远程 URL,图像格式和尺寸由 Cloudflare 校验。不支持图像的模型会拒绝带图像的请求。 Clef 最多接受 64 个问题,ID 最多 100 个字母、数字、下划线、点或连字符。选择题需要 2–255 个选项,评分题需要 2–10 个级别。请参阅 Cloudflare 的 Clef 文档。

Cloudflare Clef Omni

cloudflare/clef-omni 接受文本、图像、音频和视频。音频和视频部分是 Phaseo 对输入格式的扩展;OpenAI 路由只接受文本和图像。发送此示例前,请将占位的音频字节和视频 URL 替换为你自己的媒体。
音频可以作为 input_audio.data 发送,并设置 format: "wav" 或 "mp3";也可以作为 input_audio.url 发送,值为公共 HTTPS URL 或内联音频 data URL。input_video.video_url 接受字符串或 { "url": "..." },其中包含公共 HTTPS URL 或内联 MP4/WebM data URL。远程服务器必须返回匹配的 Content-Type。Phaseo 抓取 URL 时会进行大小限制以及私有地址和重定向检查,然后将媒体嵌入后发送给 Cloudflare;提供商凭据绝不会发送给媒体服务器。 Cloudflare 会校验媒体编码、图像尺寸和片段时长,并以每秒两帧的频率对视频采样。当请求中的每个视频都有音轨时,会使用视频的音轨。媒体 token 计入上下文和计费;Phaseo 按 Cloudflare 报告的输入用量结算,不额外收取音频或视频费用。请参阅 Cloudflare 的 Omni 契约。

Liquid D1.2 和 D1.2 Ultra

liquid-ai/d1.2 和 liquid-ai/d1.2-ultra 使用旧的 state 格式,最多接受 4 张图像和 8 段音频。audio 以 base64 data: URL 发送(WAV、MP3、FLAC、M4A 或 OGG,每个 URL 最多 24 MiB,约合 18 MiB 音频);不支持远程音频 URL。除 noul、choice 和 score 外,它们还回答以下问题类型: 在 choice 问题上设置 multiple: true,即可在 choices 中获得所有适用的选项,并附带每个选项的 probabilities。其他模型对这些问题类型返回 400,并以单个选项回答 multiple 问题;不支持音频输入的模型会忽略 audio。liquid-ai/d1、liquid-ai/d1.1 和 liquid-ai/d1-ultra 接受文本和图像,回答 noul、choice 和 score。

Liquid D1 和 Perplexity Decider

Liquid D1(liquid-ai/d1:free)在实验性抢先体验期间免费。Perplexity Decider V1.3(perplexity/pplx-decider-v1.3,或 perplexity/pplx-decider-latest)和 Decider Flash V1.3(perplexity/pplx-decider-flash-v1.3,或 perplexity/pplx-decider-flash-latest)需要在 Phaseo 中配置 Perplexity 提供商凭据。它们的图像 state 使用 PNG、JPEG 或 WebP 的 base64 data URL;不支持远程图像 URL。它们还能回答 locate 问题,返回字符串 input 或 state 中与 instructions(例如 "email address")匹配的部分。每个片段包含原样复制的 text、按 Unicode 码位计数的 start 和 end 偏移量(不含 end),以及数值越高越确定的 score;没有匹配时 spans 为空。Locate 不使用 criteria,不接受图像、音频或视频,只能在标明支持它的模型上使用;其他模型会返回 400。Perplexity 使用最多 8K token 的输入训练了该功能。在这两个模型上,选择题最多接受 255 个选项,评分题最多接受 10 个级别。

Inception Mercury Decide

inception/mercury-decide 接受文本或 JSON 证据。选择题最多接受 255 个选项,评分题最多接受 10 个级别。不支持图像、流式传输和工具调用。$0.02 的输入价格是 Inception 的五折促销价,目前没有公布结束日期;使用前请查看当前的上游定价。

Microsoft Decision

microsoft/microsoft-decision-1 运行在 Azure Foundry 部署上,接受最多 32,768 token 的文本或 JSON 证据。不支持媒体、流式传输、工具、safety_identifier 和 service_tier。请参阅 Microsoft 的指南。

Respan Span-01

Span-01 使用旧格式。state 必须是一个对话片段:由前面消息组成的 input 数组,以及一条 output 助手消息。它只回答 noul 问题:noul 值是该行为存在的概率,probabilities 还会给出不存在和无法观察到的概率。
响应如下:
respan/span-01:free 是有每日用量上限的免费 Lite 模型,对应 Respan 的 span-01-free 模型。respan/span-01 对应 span-01-pro,由 Respan 计费。Span-01 处于抢先体验阶段:Respan 必须为你的组织启用它,并且在调用任一模型之前,你需要在 Phaseo 中将你的 Respan API 密钥添加为 Respan 提供商凭据。

授权

Authorization
string
header
必填

Bearer 令牌身份验证

请求体

application/json

推荐 OpenAI 格式。原有格式仍受支持。回答遵循请求格式,请勿混用。

model
string
必填

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

Minimum string length: 1
input
必填

文本或带内联图片的消息。音频和视频是面向兼容模型的 Phaseo 扩展;OpenAI 决策路由不支持这些扩展。

Maximum string length: 10485760
questions
object[]
必填
Required array length: 1 - 1000 elements
models
string[]

在 model 之后按顺序尝试的可选回退模型。model 为必填项,且始终是主模型。当某次尝试以 429、500、502、503 或 504 失败时,会尝试下一项;其他错误按原样返回。最多接受 25 个模型 ID 或预设;重复项以及与 model 相同的项会被忽略。每次尝试都会作为独立请求进行验证、记录和计费,响应中的 model 字段和路由追踪会显示实际处理请求的模型。流式请求仅在发送第一个字节之前回退,视频和音乐任务仅在提交时回退。Batch、realtime 和 council 请求会拒绝 models。动态路由上设置的回退优先,且 phaseo/auto 不能与 models 一起使用。

Required array length: 1 - 25 elements
Minimum string length: 1
示例:
provider_options
object
safety_identifier
string | null

不透明用户标识符。仅 OpenAI 路由。

Maximum string length: 128
meta
boolean
默认值:false
echo_upstream_request
boolean
debug
object

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

provider
object

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

routing
object

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

metadata
object

响应

200 - application/json

结构化决策响应

input/数组返回有序回答;原有 state/映射返回命名映射。

model
string
必填
answers
object[]
必填

按问题顺序一一回答,包括无名称或同名问题。

usage
object
必填
request_id
string | null
meta
object
最后修改于 2026年11月16日