Laya AI。次のワークフローをオンラインで試す。

1. キーを作成して接続

ログイン後、アカウント設定の API Keys でキーを作成し、必要なクレジットを用意します。下記 URL に POST リクエストを送信してください。翻訳ページでも API パスに言語プレフィックスは付きません。

API はアプリのサーバーから呼び出してください。キーはサーバー環境変数 LAYA_API_KEY に保存し、ブラウザーのコードや公開リポジトリに含めないでください。プレイグラウンドはログインセッションを利用します。

2. モデルとリクエストを定義

model に english、multilingual、typed-decisions のいずれかを指定します。すべて choice、score、noul の質問に対応しています。

3. 最初のリクエストを送信

LAYA_API_KEY に作成したキーを設定してください。この例は1つのメッセージを3種類の質問で評価します。JavaScript は Node.js 18+ で .mjs ファイルとして実行し、Python 3 は標準の urllib を使用します。追加の Python パッケージは不要です。

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 に格納されます。チャット補完やストリーミングテキストではありません。

形式の説明用の例です。回答、トークン数、処理時間はリクエストにより異なります。

{
  "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 で結果を取得し、タイプに応じて choice、score、noul を読み取ります。確率フィールドが追加される場合もあります。

data.result.usage

input_tokens と output_tokens は実際のトークン使用量です。消費クレジットは data.creditsUsed で確認できます。

data.result.elapsedMs

リクエスト処理時間（ミリ秒）。実測値であり、遅延の保証ではありません。

data.creditsUsed

このリクエストで差し引かれたクレジット。アプリ内で実際の消費量を表示できます。

このエンドポイントには、ここで説明したリクエスト形式とレスポンス形式を使用してください。他の Laya サービスに変更する場合は、認証とレスポンス構造を確認し、必要に応じてクライアントを調整してください。

5. 制限とエラーに対応

400

JSON、モデル、コンテキスト、質問タイプまたは条件が無効です。修正して再実行してください。

401

認証情報がないか無効です。Bearer API キーを確認するかログインしてください。

402

クレジット不足です。必要な残高を追加して再実行してください。

413

本文が32 KiBを超えています。コンテキストを短くするか分割してください。

429

リクエストの間隔が短すぎます。Retry-After ヘッダーに従って待ってください。

502

推論失敗、タイムアウト、または無効な結果です。メッセージを確認し、必要に応じて再実行してください。

503

サービスを利用できません。後ほど再試行するかサポートに連絡してください。

エラー時は HTTP ステータスと message を確認します。この API は冪等性キーに未対応です。クライアントがタイムアウトしても最初の処理が完了・課金されている場合があるため、無条件に再送せず結果を確認してください。