YZ Index

API ドキュメント

API 経由で YZ Index のランキングと変動データを取得

概要

YZ Index は RESTful JSON API を提供します。全エンドポイントは GET リクエスト、認証不要、CORS 対応。UTF-8 エンコーディング。

  • Base URL：https://www.winzheng.jp/yz-index/api/
  • レスポンス形式：application/json; charset=utf-8
  • 全エンドポイントは "ok": true で成功を示し、失敗時は "ok": false と "error" フィールドを返却

ランキングデータ

GET /yz-index/api/rankings

指定次元のモデルランキングを取得。デフォルトは最新公開評価（full run）の総合ランキング。

リクエストパラメータ

パラメータ型必須説明
dimension string任意 ソート次元。execution_raw grounding_raw core_overall_display value stability。デフォルト core_overall_display。
旧値 coding / knowledge / longctx / overall はまだ使用可能、2026-06-30 に廃止予定
run_id int任意 評価バッチ ID を指定。省略時は最新公開バッチを使用

レスポンス例

{ "ok": true, "run_id": 16, "dimension": "core_overall_display", "run": { "id": 16, "run_type": "full", "status": "done", ... }, "rankings": [ { "model_slug": "claude-opus", "model_name": "Claude Opus 4", "execution_raw": 89.5, "grounding_raw": 85.2, "core_overall_display": 82.7, "integrity_label": "pass", "value": 62.3, "stability": 91.0, "availability": 100.0 } ] }

週次変動

GET /yz-index/api/changes

指定週のモデルランキング変動データを取得。上昇・下降・安定の3グループを返却。

リクエストパラメータ

パラメータ型必須説明
week string任意 週ラベル、形式 2026-W12。省略時は最新週を返却

レスポンス例

{ "ok": true, "week": "2026-W12", "weeks": ["2026-W12", "2026-W11", "2026-W10"], "up": [{ "model_slug": "gpt-4o", "direction": "up", "delta": 3.2, ... }], "down": [...], "stable": [...], "total": 11, "run": { "id": 16, "run_type": "full", "model_count": 11, ... } }

生データ

GET /yz-index/api/data

指定 run の全スコアカード（問題別結果を含む）を取得。

パラメータ型必須説明
run_idint任意評価バッチ ID。省略時は最新公開バッチ

API v1（推奨）

新しい公開リードオンリー API。API Key 不要、CORS 対応、IP あたり毎分 60 リクエスト制限。全レスポンスに attribution フィールドと 1 時間キャッシュを含む。

Base URL：https://www.winzheng.jp/yz-index/api/v1/

v1: ランキング

GET /yz-index/api/v1/leaderboard

総合ランキングを取得。ランク変動を含む。デフォルトは core_overall_display 順。

パラメータ型必須説明
dimensionstring任意ソート次元。デフォルト core_overall_display
limitint任意返却モデル数。1-50、デフォルト全件

v1: 変動・インシデント

GET /yz-index/api/v1/changes

最新期の変動とインシデントデータを取得。モデル別フィルター可能。

パラメータ型必須説明
modelstring任意モデル slug。例: deepseek-v3

v1: モデルプロフィール

GET /yz-index/api/v1/models/{slug}

指定モデルの詳細プロフィール：スコア、各次元、価格、直近 5 回の評価履歴。

パラメータ型必須説明
{slug}string必須モデル slug。例: claude-opus-4.6

v1 共通仕様

  • Rate Limit：IP あたり毎分 60 リクエスト。超過時は 429 Too Many Requests
  • CORS：Access-Control-Allow-Origin: *
  • Cache：Cache-Control: public, max-age=3600（1 時間）
  • API Key 不要、直接 GET リクエスト
  • 全レスポンスに attribution フィールドを含む。データ引用時はソースを明記
  • エラーレスポンス形式：{"status":"error","error":"..."}

v6 スコアフィールド説明

フィールド型説明
execution_rawnumberコード実行生スコア (0-100)
grounding_rawnumber資料制約生スコア (0-100)
judgment_rawnumberエンジニアリング判断生スコア (0-100, サイドランキング AI 補助)
communication_rawnumberタスク表現生スコア (0-100, サイドランキング AI 補助)
integrity_rawnumber誠実性評価生スコア (0-100)
integrity_labelstring誠実性評価ラベル (pass/warn/fail)
core_overall_rawnumberメインスコア = 0.55×execution + 0.45×grounding
core_overall_displaynumber表示スコア (integrity fail 時上限 74)
recommendation_statusstring推薦状態 (recommended/neutral/not_recommended)

エラー処理

サーバー異常時、HTTP ステータスコード 500 で以下の構造を返却：

{ "ok": false, "error": "error description" }

dimension パラメータが許可リスト外の場合は自動的に overall にフォールバック。評価データなしの場合は空の rankings 配列を返却（エラーではない）。

Widget 埋め込みコンポーネント

1 行のコードで YZ Index をあなたのサイトに埋め込み。ランキング、モデルバッジ、変動速報の 3 種類をサポート。dark/light の 2 テーマ。

Widget: ランキングカード

<script src="https://www.winzheng.jp/yz-index/widget.js" data-type="leaderboard" data-limit="5" data-theme="light"></script>

利用可能モデル slug

モデル名slugプロバイダー
Claude Opus 4.6 claude-opus-4.6 claude
Claude Sonnet 4.6 claude-sonnet-4.6 claude
GPT-4o gpt-4o gpt
GPT-o3 gpt-o3 gpt
Grok 3 grok-3 grok
Gemini 2.5 Pro gemini-2.5-pro gemini
DeepSeek V3 deepseek-v3 deepseek
DeepSeek R1 deepseek-r1 deepseek
Qwen Max qwen-max qwen
豆包 Pro doubao-pro doubao
文心一言 4.0 ernie-4 ernie

YZ Index データをご自身のプロダクトでご活用ください。引用時はソースを明記してください。