モデル · System One
はじめての Jev 呼び出し、項目ごとに
TypeSafe AI は 2026年9月20日、ウェイトリストなしで Jev をすべての人に公開しました。ドキュメントも同時に公開されたため、面白い問いは「試せるか」ではなく「実際の呼び出しがどうなっているか」になりました。
この呼び出しの案内です。送るもの、返ってくるもの、そしてそれを土台にシステムを組む前に知っておくべき公開済みの制限をたどります。Ciyo は Jev を実行しません — 画像も動画も生成せず、いずれのモデル一覧にも載りません — したがってここは製品発表ではありません。これは、クリエイティブやエージェント向けツールの内部に関心を持つ者による、新たに公開された API の読み解きです。
呼び出しは 1 回の POST
すべては 1 つのエンドポイント `POST https://api.typesafe.ai/v1/systemone` に送り、Authorization ヘッダーに bearer キー、本文に JSON を入れます。
本文には 3 つの必須フィールドがあります。`state` は判定の対象 — 文字列、JSON オブジェクト、またはテキスト値の配列です。`model` はモデル名（例：`jev-latest`）。`questions` はあなた独自の質問 ID から型付きの質問へのマップです。
応答はこれを反映します。`answers` は同じ質問 ID をキーとするマップで、`usage` は入力と出力のトークン数を報告します。出力トークンは 0 で課金されるため、この usage ブロックは送った state の量を記録するものにすぎません。
3 つの質問タイプと、見分ける方法
Choice は、宣言したリストから 1 つの選択肢を選びます。あなたは `instructions` と、選択肢名からその説明への `criteria` マップを渡し、オプションの上限は 255 とドキュメントにあります。返るのは選ばれた選択肢、各選択肢の確率、そして信頼度の値です。
Score は state を、配列として渡す 2 から 10 段階のルーブリックに当てはめます。返るのは、段階の間に入り得るスコア、各確率、凡例、そして信頼度の値です。
Noul は 1 つの真偽文に答え、0 から 1 の単一の数値を返します。任意の `criteria` で真と偽の姿を記述できます。これがもっとも手軽に使え、人が使いすぎるものです。
Choice と Score の実用的な違いはドキュメントからは明らかでなく、踏み切る前に同じ state で両方を走らせる価値があります — 自分のコード内のスコアとしきい値と、明示的な選択肢の間の選択は、たいてい同じ答えになっても同じ決定ではないのです。
2026-09-20 に TypeSafe AI（モデルのベンダー）が投稿、console.typesafe.ai を指す。これが早期アクセスのウェイトリストをオープンなサインアップに変え、本記事が今日あなたが発行できる呼び出しを説明できる理由である。
すべての質問は同じ state に対して判定される
これは API の形が筋道立つようにする設計の核心です。state を 1 回送ると、マップ内の各質問がそれに対して並列かつ独立に評価されます。質問同士は互いの答えを見ません。
これには 2 つの帰結があります。質問を増やすのは安く、なぜなら呼び出しのコストを支配するのは答えることではなく state を送ることだからです。そして連鎖はあなたの役割です。質問 2 が質問 1 が「はい」と言ったときだけ走るべきなら、そのロジックは返ってきた答えの上の、あなたのコードにあります。
設計時に留意すべき制限
このうち 4 つは TypeSafe が公開しています。5 つ目は独立評価によるもので、本番で一番咬みつきやすいものです。
価値ある最初の呼び出し
本当に自動化したい決定から始めてはいけません。手で既にラベル付けした決定から始めましょう。なぜなら 1 日目に面白い数字は、あなた自身のラベルとの一致率だけだからです。
あなたが判定した 50 行を取り、それぞれを state として送り、既に答えた質問を問います。すべての答えに信頼度の値を添えて残します。これで自分のデータに対する一致率とキャリブレーション曲線が得られ、公開済みのベンチマークより価値があります。
POST https://api.typesafe.ai/v1/systemone
Authorization: Bearer $TYPESAFE_API_KEY
{
"model": "jev-latest",
"state": { "subject": "...", "body": "...", "sender": "..." },
"questions": {
"urgent": { "type": "noul", "instructions": "このメッセージは今日返信が必要です。" },
"topic": { "type": "choice", "instructions": "これはどのキューに回すべきですか？",
"criteria": { "billing": "...", "bug": "...", "none_of_these": "上記のいずれにも当てはまらない。" } }
}
}できないこと
これは何も書きません。要約も、書き換えた文も、コードも、代替テキストも、画像もなし。必要な出力が散文なら、これは間違った道具で、普通の言語モデルが正しい選択です。
受け取るのはテキストのみです。ドキュメントによれば state は文字列、JSON オブジェクト、またはテキスト値の配列でなければならず、画像・音声・動画はまだ非対応です。
もっとも強いのは英語です。ドキュメントによれば英語が学習の主言語であり、CJK を含む他言語は精度が低く受け付けられる — サポートのキューが英語でなければ問題になる点です。
そして、どの選択肢も当てはまらないとは教えてくれません。その選択肢は自分で宣言してください。
最初の呼び出しに関する質問
ウェイトリストの招待はまだ必要ですか？
いいえ。TypeSafe は 2026年9月20日、Jev がウェイトリストなしでだれでも使え、console.typesafe.ai から利用できると発表しました。
どの質問タイプから始めるべきですか？
Noul です。手で既にラベル付けした決定用です。1 つの数値を返すため、最初の一致チェックを点数化するのは取るに足りません。
1 回の呼び出しに何件の質問を入れられますか？
ドキュメントに上限は公開されていません。ただし質問は同じ state に対して並列に評価され、ある独立した実行では 1 回の呼び出しで 800 件の判定を入れました。
Ciyo は Jev を使えますか？
いいえ。Jev は画像も動画も生成せず、Ciyo のいずれのモデル一覧にも載りません。私たちが書くのは、エージェント向けツールの背後にある機構の一部だからであり、実行しているからではありません。
続きを読む
Ciyo はクリエイティブやエージェント向けツールの背後にあるモデルについて書き、実行できるものを試験します。