跳转至

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

参数名 类型 必填 描述
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);