Jev の入手方法：API Key、無料トライアル、すべての選択肢

Jev を使う 3 つの方法

Jev は TypeSafe の System One モデルです。公開ビルドは jev-1.13.0 の 1 つだけで、次の 3 つの方法で利用できます。

1. JevStation の新規登録不要トライアル：ブラウザで、アカウントなし、プリセットのユースケースのみ。
2. JevStation のアカウントと API Key：200 クレジット無料、その後は買い切りのクレジットパック。
3. TypeSafe 直接：モデル提供元の API、ウェイトリスト制。

1. プレイグラウンドでの JevStation トライアル

手順。 プレイグラウンド を開き、上のサポート振り分けの例などのプリセットを選び、必要ならテキストを編集して実行します。

料金。 無料です。IP アドレスごとに 1 日 3 回実行できます。

メリット。 アカウントもカードもコードも不要です。実際のモデルから実際の確率が数秒で返ってきます。

デメリット。 質問はプリセットのもので変更できず、編集できるテキストは 2,000 文字までです。Jev がどう答えるかを見るための方法であり、自分のユースケースをテストするための方法ではありません。

向いている人： Jev をもっと詳しく検討する価値があるか判断したい人。

2. JevStation のアカウントと API Key

手順。 新規登録 して 設定 › API Keys を開き、キーを作成して、それを使って POST https://jevstation.com/api/v1/systemone を呼び出します。同じアカウントで、自分の質問を使ってプレイグラウンドも利用できます。

料金。 新しいアカウントには 30 日間有効な 200 クレジットが無料で付与され、カードもプロバイダーのキーも不要です。その後のクレジットはサブスクリプションではなく買い切りのパックで、5,000 クレジットが $9.90、12,000 クレジットが $15.90、有効期間は 24 か月です。標準の評価（state 8,000 文字まで、質問 5 つまで）は 1 クレジットです。それより大きい評価（24,000 文字まで、質問 12 個まで）は 3 クレジットです。失敗した評価は自動的に返金されます。詳しくは 料金 をご覧ください。

メリット。 ウェイトリストがありません。トークン単位ではなく評価単位で支払うため、リクエストの価格がモデルのトークン化の仕方に左右されません。さらに、質問セットを設計するためのプレイグラウンド、保存された評価スレッド、自動返金も利用できます。

デメリット。 1 回あたりでは、生のトークン費用より高くなります。典型的な評価は Jev の定価で約 $0.00002 ですが、1 クレジットは小さいパックで $0.00198、大きいパックで $0.00133 です。スループットにはアカウントごとの上限があり、購入したパックに応じて上限が上がります。現在の上限は GET /api/v1/systemone で確認できます。このデプロイではモデルバージョンが固定されているため、リクエスト内の model フィールドは無視されます。

向いている人： 今すぐ Jev を呼び出したい開発者、API と並べてプレイグラウンドを使いたいチーム、利用量が非常に大規模ではないすべての人。

3. TypeSafe 直接

手順。 TypeSafe のウェイトリストに登録します。承認されたら、TypeSafe のキーを使って POST https://api.typesafe.ai/v1/systemone を呼び出します。LangChain が公式の連携を公開しており、Python 向けは langchain-typesafe、JavaScript 向けは @langchain/typesafe です。

料金。 従量課金で、入力トークン 100 万あたり $0.042、出力トークンは無料です。セルフサービスのプランや無料枠はありません。より高い上限やデータ保持ゼロについては、TypeSafe の営業チーム経由となります。

メリット。 1 回あたりの価格が最も安く、レート制限が最も高く（TypeSafe の公表値で 1 分あたり 1,200 リクエスト、1 秒あたり 250,000 トークン）、jev-latest や jev-preview のエイリアスを含め、モデルバージョンを自分で制御できます。

デメリット。 利用開始まで待つ必要があります。また TypeSafe によると、レート制限は動的に調整中で、予告なく変更される可能性があります。

向いている人： アクセスを待てる、大量利用の本番ワークロード。

JevStation API を呼び出す

どの例も、上のトライアルと同じサポートチケットを 2 つの質問とともに送ります。$JEVSTATION_API_KEY は作成したキーに置き換えてください。

cURL

curl -X POST https://jevstation.com/api/v1/systemone \
  -H "Authorization: Bearer $JEVSTATION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "state": "I have been trying to connect my Stripe account for 3 days and it keeps failing with invalid redirect. I am losing sales every hour.",
    "questions": {
      "category": {
        "type": "choice",
        "instructions": "Which team should handle this support ticket?",
        "criteria": {
          "billing": "Payments, invoices, refunds or plan changes",
          "integrations": "Connecting or syncing a third-party service",
          "bug": "The product behaves incorrectly",
          "account": "Login, access or account settings"
        }
      },
      "churn_risk": {
        "type": "noul",
        "instructions": "Is the customer at risk of churning?"
      }
    }
  }'

Python (requests)

import os
import requests

resp = requests.post(
    "https://jevstation.com/api/v1/systemone",
    headers={"Authorization": f"Bearer {os.environ['JEVSTATION_API_KEY']}"},
    json={
        "state": "I have been trying to connect my Stripe account for 3 days "
                 "and it keeps failing with invalid redirect. I am losing sales every hour.",
        "questions": {
            "category": {
                "type": "choice",
                "instructions": "Which team should handle this support ticket?",
                "criteria": {
                    "billing": "Payments, invoices, refunds or plan changes",
                    "integrations": "Connecting or syncing a third-party service",
                    "bug": "The product behaves incorrectly",
                    "account": "Login, access or account settings",
                },
            },
            "churn_risk": {
                "type": "noul",
                "instructions": "Is the customer at risk of churning?",
            },
        },
    },
    timeout=30,
)
body = resp.json()
if body["code"] != 0:
    raise RuntimeError(body["message"])

data = body["data"]
print(data["answers"]["category"]["choice"], data["answers"]["category"]["confidence"])
print(data["answers"]["churn_risk"]["noul"])
print("credits left:", data["credits"]["remaining"])

Node (fetch)

const res = await fetch('https://jevstation.com/api/v1/systemone', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.JEVSTATION_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    state:
      'I have been trying to connect my Stripe account for 3 days and it keeps failing with invalid redirect. I am losing sales every hour.',
    questions: {
      category: {
        type: 'choice',
        instructions: 'Which team should handle this support ticket?',
        criteria: {
          billing: 'Payments, invoices, refunds or plan changes',
          integrations: 'Connecting or syncing a third-party service',
          bug: 'The product behaves incorrectly',
          account: 'Login, access or account settings',
        },
      },
      churn_risk: {
        type: 'noul',
        instructions: 'Is the customer at risk of churning?',
      },
    },
  }),
});

const body = await res.json();
if (body.code !== 0) throw new Error(body.message);

const { answers, credits } = body.data;
console.log(
  answers.category.choice,
  answers.churn_risk.noul,
  credits.remaining
);

返ってくる内容

レスポンスはエンベロープ形式です。code は成功時に 0、エラー時に -1、message は ok またはエラーの内容で、結果は data の下に入ります。以下の値は形式を示すためのもので、実際の数値は異なります。

{
  "code": 0,
  "message": "ok",
  "data": {
    "model": "jev-1.13.0",
    "answers": {
      "category": {
        "type": "choice",
        "choice": "integrations",
        "probabilities": {
          "billing": 0.2,
          "integrations": 0.7,
          "bug": 0.08,
          "account": 0.02
        },
        "confidence": 0.6
      },
      "churn_risk": { "type": "noul", "noul": 0.8 }
    },
    "usage": { "input_tokens": 180, "output_tokens": 0 },
    "credits": { "charged": 1, "remaining": 199 },
    "latency_ms": 400
  }
}

Choice の回答には、最上位の選択肢、すべての選択肢の確率、信頼度が含まれます。Score の回答には、設定したレベル上の値、凡例、信頼度が含まれます。Noul の回答は 0 から 1 までの単一の確率で、信頼度はありません。エラー時には実際の HTTP ステータスも設定されます。キーがない・無効な場合は 401、リクエストが不正・大きすぎる場合は 400 または 413、クレジット不足の場合は 402、レート制限に達した場合は 429、評価が失敗した場合は 502 で、この場合クレジットは返金されます。すべてのフィールドは ドキュメント で解説しています。

比較早見表

API Key を取得して最初の呼び出しを行う

1. 新規登録する。 /sign-up でアカウントを作成します。30 日間有効な 200 クレジットが無料で付与されます。
2. キーを作成する。 設定 › API Keys を開いてキーを作成します。コードに直接書かず、JEVSTATION_API_KEY として保存してください。
3. キーを確認する。 同じ Bearer ヘッダーで GET https://jevstation.com/api/v1/systemone を送信します。費用はかからず、プラン、残りクレジット、レート制限が返ります。
4. 最初の呼び出しを行う。 上のいずれかの例を実行します。標準の評価なので、1 クレジットかかります。

コードを書く前に、まず プレイグラウンド で質問を設計しておくことをおすすめします。同じ仕様で動いており、そこで見える回答がそのままコードで得られる回答です。質問の書き方は Jev が答えられる質問の設計 で、各呼び出しの背後にあるトークン費用の内訳は Jev の評価 1 回にかかる費用 で解説しています。