Typesafe_Jev_1.14
模型概览
| 项 | 值 |
|---|---|
| 模型 ID(model) | jev-1.14.0 |
| 发布时间 | 2026-10-14 |
| 上下文长度 | 默认单请求 64k tokens、单问题 32k tokens。请求头 TypeSafe-Danger-Zone-Long-Context: true 时,两者都变为 262k tokens。长上下文更慢、准确率更低,按 token 单价与默认上下文相同 |
| 最大输入 | 同时受 per_request_context(state 加全部问题)和 per_question_context(state 加任意一道题)约束。问题数量没有单独上限 |
| 最大输出 | 源文档未给出输出 token 上限。响应返回 usage.output_tokens,输出 token 不计费 |
| 输入模态 | 文本:state 为 string、JSON object 或 array。不接受音频、视频。图片为实验能力(文档称 Dreamer-ready,格式与准确率可能随版本变化),Jev 1.13 与 Jev 1.14 都可在带 TypeSafe-Danger-Zone-Images: true 时接收图片;Box 需要 Jev 1.14 |
| 输出模态 | 结构化答案:noul、choice、score、box。不生成自然语言 |
| 输入价格 | $0.042 / 百万 input tokens($42 / 十亿 input tokens)。只对 input tokens 计费 |
| 语言 | 英文为主、准确率最高。其他语言(含中日韩)可处理,准确率较低,需用自有数据验证,并关注 confidence |
| 速率限制 | 按组织配置,维度为 tokens/s 与 requests/s,具体数值在开发者控制台。超限返回 429,响应可能带 retry-after |
请求协议
https
Header
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Content-Type | string | 是 | application/json |
| Authorization | string | 是 | Bearer YOUR_API_KEY |
TypeSafe System One
请求 URL
POST https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/systemone
Header(本协议额外)
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| TypeSafe-Danger-Zone-Images | string | 否 | 唯一允许值 true。请求含图片或 type=box 时厂商要求携带,否则 400。默认关闭。 |
| TypeSafe-Danger-Zone-Long-Context | string | 否 |
唯一允许值 true。开启后单请求与单问题上下文都为 262k tokens。默认关闭。Jev 1.14 与 Jev 1.13 都支持。 |
请求 Body 参数
| 参数名 | 二级参数 | 三级参数 | 四级参数 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| model | - | - | - | string | 是 | 固定为 MaaS_Typesafe_Jev_1.14(厂商原始 model:jev-1.14.0)。厂商也接受别名 jev-latest、jev-preview,二者当前指向 jev-1.14.0 |
| state | - | - | - | string | object | array | 是 | 所有题目共同评估的内容,只评估一次。string 适合单段文本;object 适合带字段名的记录;array 适合消息或记录序列。可用反引号引用字段路径,如 `ticket.subject`。与问题互相独立:内容放 state,判断放 questions。不支持音频、视频。嵌套最多 64 层 |
| questions | - | - | - | object | 是 | 至少 1 个键。键为调用方自定的问题 ID,原样作为 answers 的键返回,不送给模型。同一请求可混用多种 type,各题独立评估。全部题目加上 state 须落在单请求上下文内;任一题加上 state 须落在单问题上下文内 |
| {key} | - | - | object | 是 | 一道题。type 决定其余字段 |
|
| type | - | string | 是 | noul:是/否概率。choice:从无序选项中选一个。score:在有序等级上打分。box:在图片中定位一个目标(需 Jev 1.14,且须带 Images Header;无「未找到」,目标不在图中仍返回四条边) |
||
| instructions | - |
string | object | array | null | 否 | 要判断的问题或陈述。schema 允许缺省或 null,文档示例都填写。object/array 用于把问题与对照数据拆开,并用反引号引用字段名。嵌套最多 64 层。box 不要求问句,写出目标和图片即可,例如 the coffee mug in \photo\``。图片引用写在字符串中,只属于该题 |
||
| criteria | - | object | array | 视 type | noul:可选,说明何为 yes/no。choice:必填,1~255 个选项。score:必填,有序等级数组,API 最少 1 项、最多 10 项,文档建议至少 2 级。box:无此字段。嵌套最多 64 层。对象键(选项名、问题 ID)不会被图片引用替换 |
||
| true | string | object | array | null | 否 | 仅 noul。何为 yes。可内嵌图片引用 |
|||
| false | string | object | array | null | 否 | 仅 noul。何为 no。可内嵌图片引用 |
|||
| {optionName} | string | object | array | null | 是 | 仅 choice。键为选项名(响应 choice 返回该键),值是该选项何时成立。值为 null 时只按选项名理解。选项名与描述都会送给模型。文档建议列表可能覆盖不全时增加 other 或 none of the above。结构字段名由调用方自定,不是保留字 |
|||
| assets | - | - | - | object | 否 | 图片资源,键为引用字符串。该字符串出现在 state、instructions、criteria 的字符串值中时被替换成图片(对象键不替换)。每个引用必须至少出现一次,否则 400。未被引用、空引用、仅空白的引用会 400。单个引用最长 1024 字节 UTF-8,全部引用合计最长 65536 字节。短引用可能误匹配普通单词,文档建议每张图使用新的 UUID。同一引用每出现一次,模型侧都再计一份图片,并计入展开后的 32 MiB。至少 1 个键。需要 vision 模型与 Images Header。 |
| {key} | - | - | object | 是 | 一张图。part 与 data_base64 二选一;两者都有时厂商使用 part |
|
| type | - | string | 否 | 若填写,只能是 image |
||
| format |
- | string | 视上传方式 | png、jpg、jpeg(jpeg 即 jpg),小写。与 data_base64 一起时必填;与 part 一起时可选。实际格式还按字节检测 |
||
| data_base64 |
- | string | 视上传方式 | 标准 Base64(带 = 填充),无换行、无空白、无 data: 前缀。未设置 part 时必填 |
||
| part |
- | string | 视上传方式 | multipart 中图片 part 的名字。设置后忽略 data_base64。每个文件 part 必须只被一个 asset 引用 |
score 的 criteria 是数组而不是命名对象。元素为 string、object 或 array,下标从 0 起,下标即等级。响应 score 是各等级编号按概率的加权平均,可以落在两个整数等级之间。模型只看等级描述,看不到等级编号;描述应写清情境,而不是只写「0/1/2」或「比上一级更严重」。
图片限制(厂商,含两端):PNG 或 JPEG 静图,动图 PNG 拒绝;单文件最大 16 MiB(Base64 按解码后大小);宽、高各 280~1568 像素;总像素 78400~2458624;不会自动缩放。请求体、全部图片处理之后、引用展开之后,各自最大 32 MiB。任一张图不合法则整请求失败。EXIF 方向不会被应用,需事先把像素转正。图片 token 计入 usage.input_tokens 和上下文,无单独单价。token 估算方法源文档写明尚未提供。
multipart 规则(厂商推荐,避免 Base64 放大):第一个 part 名为 request,Content-Type: application/json;每个图片 part 的 Content-Type 为 image/png、image/jpeg、image/jpg、application/octet-stream 或省略,其他类型返回 400。request 为保留名。当前 MaaS 入口不按 multipart 绑定。
响应 Body 参数
| 参数名 | 二级参数 | 三级参数 | 四级参数 | 类型 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| model | - | - | - | string | 是 | 经 MaaS 网关返回时为请求中的 MaaS 模型名 MaaS_Typesafe_Jev_1.14。厂商直连时为实际作答版本,别名请求会解析成 jev-1.14.0,可能与请求里的别名不同 |
| answers | - | - | - | object | 是 | 至少 1 个键,键与请求 questions 的键一致。type 与对应题目相同 |
| {key} | - | - | object | 是 | 一道题的答案 | |
| type | - | string | 是 | noul、choice、score 或 box |
||
| noul | - | number | 视 type | 仅 noul。yes 的概率,0~1。接近 1 为 yes,接近 0 为 no,接近 0.5 为不确定。没有单独的 confidence。它不是程度刻度 |
||
| choice | - | string | 视 type | 仅 choice。probabilities 最高的选项名 |
||
| score | - | number | 视 type | 仅 score。等级编号的期望值,范围为 0 到最高等级编号,可为小数。相同分数可由不同概率分布得到,需同时看 probabilities 与 confidence |
||
| confidence | - | number | null | 视 type | choice、score 必填,0~1,由概率分布的集中程度计算,不是正确性保证。box 必填但可为 null(模型未给置信度时为 null),0~1,1 更有把握。源文档没有推荐的 Box 阈值 |
||
| probabilities | - | object | 视 type | choice:各选项概率,键为选项名。score:各等级概率,键为等级编号字符串,与 legend 相同。值在 0~1,和约等于 1。noul、box 无此字段 |
||
| legend | - | object | 视 type | 仅 score。等级编号字符串到请求 criteria 描述的映射,便于解释 score。描述里的图片引用在响应中仍是引用字符串,不是图片字节 |
||
| box | - | object | 视 type | 仅 box。四条边都是相对图像尺寸的期望位置,0~1。原点在左上;left < right,top < bottom |
||
| top | number | 是 | 上边,占图像高度的比例,从顶部量起 | |||
| bottom | number | 是 | 下边,占图像高度的比例,从顶部量起 | |||
| left | number | 是 | 左边,占图像宽度的比例,从左侧量起 | |||
| right | number | 是 | 右边,占图像宽度的比例,从左侧量起 | |||
| usage | - | - | - | object | 是 | 本次 token 用量 |
| input_tokens | - | - | integer | 是 | 计费的 input tokens,含图片 token | |
| output_tokens | - | - | integer | 是 | 答题所用 output tokens。当前不计费 |
请求示例
curl -X POST 'https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/systemone' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-d '{
"model": "MaaS_Typesafe_Jev_1.14",
"state": {
"subject": "Duplicate charge",
"message": "I was charged twice for my subscription this month. Please refund the extra charge."
},
"questions": {
"billing": {
"type": "noul",
"instructions": "Is this message about billing?"
},
"repeat_contact": {
"type": "noul",
"instructions": "Has the customer contacted support about this before?",
"criteria": {
"true": "Mentions a prior attempt, ticket, or that they have asked before",
"false": "No sign of any previous contact"
}
},
"tone": {
"type": "choice",
"instructions": "What is the tone of this message?",
"criteria": {
"angry": "An upset or hostile message",
"calm": "A neutral or polite message",
"excited": "An enthusiastic or eager message"
}
},
"urgency": {
"type": "score",
"instructions": "How urgent is this message?",
"criteria": [
"Can wait",
"Needs attention this week",
"Needs attention today"
]
}
}
}'
响应示例
{
"model": "MaaS_Typesafe_Jev_1.14",
"answers": {
"billing": {
"type": "noul",
"noul": 0.98
},
"repeat_contact": {
"type": "noul",
"noul": 0.07
},
"tone": {
"type": "choice",
"choice": "calm",
"confidence": 0.7,
"probabilities": {
"angry": 0.15,
"calm": 0.8,
"excited": 0.05
}
},
"urgency": {
"type": "score",
"score": 1.7,
"confidence": 0.55,
"legend": {
"0": "Can wait",
"1": "Needs attention this week",
"2": "Needs attention today"
},
"probabilities": {
"0": 0.1,
"1": 0.1,
"2": 0.8
}
}
},
"usage": {
"input_tokens": 120,
"output_tokens": 12
}
}
Box 请求示例
厂商协议示例。assets 与 TypeSafe-Danger-Zone-Images 当前不会被 MaaS 网关转发,此调用打到网上游时图片与该 Header 会丢失。
curl -X POST 'https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/systemone' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'TypeSafe-Danger-Zone-Images: true' \
-d '{
"model": "MaaS_Typesafe_Jev_1.14",
"state": {"photo": "6e1d0b7c-kitchen"},
"assets": {
"6e1d0b7c-kitchen": {
"type": "image",
"format": "jpg",
"data_base64": "/9j/4AAQSkZJRg..."
}
},
"questions": {
"mug_visible": {
"type": "noul",
"instructions": "Is there a coffee mug in `photo`?"
},
"mug": {
"type": "box",
"instructions": "the coffee mug in `photo`"
}
}
}'
Box 响应示例
{
"model": "MaaS_Typesafe_Jev_1.14",
"answers": {
"mug_visible": {
"type": "noul",
"noul": 0.97
},
"mug": {
"type": "box",
"box": {
"top": 0.25,
"bottom": 0.82,
"left": 0.44,
"right": 0.84
},
"confidence": 0.92
}
},
"usage": {
"input_tokens": 290,
"output_tokens": 21
}
}
像素坐标:left/right 乘图像宽度,top/bottom 乘图像高度。目标可能不在图中时,用同请求里的 Noul 决定是否采用这个框。
SDK 调用方式
官方 Python / JavaScript SDK 的 base_url 会请求 {base_url}/v1/systemone。MaaS 路径是 /v1/ai/{endpointPath}/systemone,不能把 base_url 直接改成网关主机。下面用 HTTP 客户端调用 MaaS。
import os
import requests
response = requests.post(
"https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/systemone",
headers={
"Authorization": f"Bearer {os.environ['MAAS_API_KEY']}",
"Content-Type": "application/json",
},
json={
"model": "MaaS_Typesafe_Jev_1.14",
"state": "I was charged twice. Please help.",
"questions": {
"billing": {
"type": "noul",
"instructions": "Is this about billing?",
},
"tone": {
"type": "choice",
"instructions": "What is the tone?",
"criteria": {"calm": None, "angry": None},
},
},
},
timeout=60,
)
response.raise_for_status()
body = response.json()
print(body["model"], body["answers"]["billing"]["noul"])
const response = await fetch(
"https://genaiapi.cloudsway.net/v1/ai/{endpointPath}/systemone",
{
method: "POST",
headers: {
Authorization: `Bearer ${process.env.MAAS_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "MaaS_Typesafe_Jev_1.14",
state: "I was charged twice. Please help.",
questions: {
billing: {
type: "noul",
instructions: "Is this about billing?",
},
tone: {
type: "choice",
instructions: "What is the tone?",
criteria: { calm: null, angry: null },
},
},
}),
},
);
const body = await response.json();
console.log(body.model, body.answers.billing.noul);