Laya AI，在线试一试你的下一个工作流。

1. 创建密钥并连接接口

登录后，在账户设置的 API Keys 中创建密钥，并确保账户有足够积分。向下方地址发送 POST 请求。API 路径不带语言前缀，中文页面也使用同一个地址。

请从你自己的应用服务端调用接口，把密钥放在名为 LAYA_API_KEY 的服务端环境变量中，不要写入浏览器代码或公开仓库。本站 Playground 使用登录会话，无需手动填写密钥。

2. 选择模型并定义请求

model 可填写 english、multilingual 或 typed-decisions。三个选项均支持 choice、score、noul 类型的问题。

3. 发起第一次请求

先将 LAYA_API_KEY 设置为你创建的密钥。示例使用三种问题类型分析同一条消息。JavaScript 使用 Node.js 18+ 运行（保存为 .mjs 文件）；Python 3 使用内置 urllib 模块，无需安装额外依赖。

export LAYA_API_KEY="YOUR_API_KEY"

curl --fail-with-body --request POST 'https://thejevai.com/laya/v1/systemone' \
  --header "Authorization: Bearer $LAYA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "english",
  "state": "I was charged twice for my subscription. Please refund the extra payment today.",
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "Which team should handle this request?",
      "criteria": {
        "billing": "Payments and refunds",
        "technical": "Bugs and outages"
      }
    },
    "priority": {
      "type": "score",
      "instructions": "How urgent is this request?",
      "criteria": [
        "Low",
        "Medium",
        "High"
      ]
    },
    "refund": {
      "type": "noul",
      "instructions": "Is the customer requesting a refund?",
      "criteria": {
        "true": "A refund is requested",
        "false": "No refund is requested"
      }
    }
  }
}'

4. 读取答案、用量和积分

使用结果前，同时检查 HTTP 状态和 code === 0。成功响应的答案位于 data.result 中，不是聊天补全或流式文本响应。

以下为结构示例，答案、token 用量和耗时会随请求变化。

{
  "code": 0,
  "message": "ok",
  "data": {
    "result": {
      "model": "english",
      "answers": {
        "department": {
          "type": "choice",
          "choice": "billing",
          "probabilities": {
            "billing": 0.97,
            "technical": 0.03
          }
        },
        "priority": {
          "type": "score",
          "score": 1.8,
          "legend": {
            "0": "Low",
            "1": "Medium",
            "2": "High"
          }
        },
        "refund": {
          "type": "noul",
          "noul": 0.98
        }
      },
      "usage": {
        "input_tokens": 1200,
        "output_tokens": 0
      },
      "elapsedMs": 142
    },
    "creditsUsed": 2
  }
}

data.result.answers

使用请求时的问题 ID 查找结果，根据 type 读取 choice、score 或 noul；部分结果还包含概率字段。

data.result.usage

input_tokens 和 output_tokens 表示实际 token 用量，消耗积分请查看 data.creditsUsed。

data.result.elapsedMs

本次请求处理耗时，单位毫秒。这是实际观测值，不是延迟保证。

data.creditsUsed

本次已扣除的积分，可用于在你的应用中展示实际消费。

接入本接口时，请使用这里说明的请求和响应格式。如果改用其他 Laya 服务，请核对其鉴权方式和响应结构，并相应调整客户端。

5. 了解计费、限制和错误处理

400

JSON、模型、上下文、问题类型或 criteria 不符合要求。修改请求后再试。

401

未登录或密钥无效。检查 Bearer API Key，或登录 Playground。

402

积分不足。补充积分，确认余额足够后再试。

413

请求体超过 32 KiB。缩短上下文或拆分请求。

429

请求间隔过短。按响应头 Retry-After 指定的时间等待后再试。

502

推理失败、超时或返回结果无效。查看错误消息，确认后酌情重试。

503

服务不可用。稍后重试或联系支持。

错误处理应读取 HTTP 状态和 message。本接口不支持幂等键：客户端超时后，原请求仍可能已完成并计费，因此不要无条件自动重试付费请求。