/ REST API

API ドキュメント.

プログラムによる照会: Pricemon の価格データにアクセス。すべてのエンドポイントは GET, で、UTF-8 JSON を返し、認証不要です。レスポンスは 5–60 分キャッシュ可能( Cache-Control ヘッダー参照)。

base-url

本番 (同一オリジン、メインサイトと共用)

https://pricemon.net/api/…

本番 (API サブドメイン、/api/* のみ)

https://api.pricemon.net/api/…

エンドポイント一覧

メソッド	パス	説明
GET	/api/meta	サイト統計:総件数、ベンダー数、カテゴリ分布、最新検証日
GET	/api/prices	全価格。vendor / category / q / currency / reasoning / free でフィルタ可能
GET	/api/prices/:slug	単一モデルの詳細。slug は modelId の小文字化(例: gpt-6-astra)
GET	/api/compare	比較マトリクスデータ(CompareModel[] 裸配列;?lang= ローカライズ;M1-0 でビルド時データ島を置換)
GET	/api/vendors	ベンダー一覧(件数とロゴパス付き)
GET	/api/categories	カテゴリ一覧(件数付き)
GET	/api/changes	価格変動ログ(日付降順)

エンドポイント詳細

GET /api/meta

サイト統計:総件数、ベンダー数、カテゴリ分布、最新検証日

レスポンス例

{
  "ok": true,
  "data": {
    "total": 146,
    "vendors": 17,
    "categories": 7,
    "byCategory": {
      "会話": 79,
      "画像生成": 23,
      "動画生成": 27
    },
    "updatedAt": "2026-09-04"
  }
}

GET /api/prices

全価格。vendor / category / q / currency / reasoning / free でフィルタ可能

Query パラメータ

パラメータ	型	説明
vendor	string	ベンダーで完全一致フィルタ。例: OpenAI、DeepSeek
category	string	カテゴリフィルタ:対話 / 画像生成 / 動画生成 / 音声合成 / 音声認識 / 音楽生成 / 3D 生成
q	string	キーワード検索。ベンダー / モデル名 / modelId に一致
currency	string	通貨フィルタ:CNY または USD
reasoning	boolean	true / false — 深い思考対応(非対応)モデルのみ返す
free	boolean	true / false — 無料(有料)モデルのみ返す
retired	boolean	true / false — 公式に提供終了 / 販売終了したモデル(または販売中)のみ返す

レスポンス例

{
  "ok": true,
  "count": 1,
  "data": [
    {
      "vendor": "DeepSeek",
      "vendorLogo": "https://pricemon.net/logos/deepseek.png",
      "model": "DeepSeek-V4-Flash",
      "modelId": "deepseek-v4-flash",
      "slug": "deepseek-v4-flash",
      "category": "会話",
      "currency": "CNY",
      "unit": "100万トークン",
      "input": 3,
      "output": 9,
      "cacheRead": 0.1,
      "context": 1000000,
      "maxOutput": 384000,
      "modalities": [
        "テキスト"
      ],
      "reasoning": true,
      "free": false,
      "retired": false,
      "batchOff": null,
      "tiers": null,
      "inputLabel": "¥3",
      "outputLabel": "¥9",
      "sourceUrl": "https://api-docs.deepseek.com/zh-cn/quick_start/pricing",
      "updatedAt": "2026-09-04",
      "note": "默认思考模式;空闲时段输入输出半价"
    }
  ]
}

GET /api/prices/:slug

単一モデルの詳細。slug は modelId の小文字化(例: gpt-6-astra)

レスポンス例

{
  "ok": true,
  "data": {
    "vendor": "Volcano Ark",
    "vendorLogo": "https://pricemon.net/logos/volcengine.png",
    "model": "Seedance 2.0",
    "modelId": "doubao-seedance-2.0",
    "slug": "doubao-seedance-2.0",
    "category": "動画生成",
    "currency": "CNY",
    "unit": "100万トークン",
    "input": null,
    "output": null,
    "cacheRead": null,
    "context": null,
    "maxOutput": null,
    "modalities": [
      "テキスト",
      "画像",
      "動画"
    ],
    "reasoning": false,
    "free": false,
    "retired": false,
    "batchOff": null,
    "inputLabel": "—",
    "outputLabel": "—",
    "tiers": [
      {
        "label": "480p/720p 输入含视频(在线)",
        "price": 28,
        "input": null,
        "output": null,
        "note": null,
        "resolution": [
          "480p",
          "720p"
        ],
        "hasVideoInput": true,
        "generateAudio": null,
        "offline": false,
        "durationSeconds": null,
        "promotionNote": null,
        "expiresAt": null
      },
      {
        "label": "1080p 输入不含视频(在线,原价限时72折)",
        "price": 46,
        "input": null,
        "output": null,
        "note": null,
        "resolution": [
          "1080p"
        ],
        "hasVideoInput": false,
        "generateAudio": null,
        "offline": false,
        "durationSeconds": null,
        "promotionNote": "限时 72 折(原价刊例价)",
        "expiresAt": "2026-09-17T14:00:00+08:00"
      }
    ],
    "sourceUrl": "https://www.volcengine.com/docs/82379/1544106",
    "updatedAt": "2026-09-04",
    "note": "离线暂不支持;…"
  }
}

GET /api/compare

比較マトリクスデータ(CompareModel[] 裸配列;?lang= ローカライズ;M1-0 でビルド時データ島を置換)

レスポンス例

[
  {
    "slug": "deepseek-v4-1-flash",
    "vendor": "DeepSeek",
    "logo": "/logos/deepseek.png",
    "model": "DeepSeek-V4.1-Flash",
    "modelId": "deepseek-v4-1-flash",
    "category": "会話",
    "currency": "CNY",
    "unit": "100万トークン",
    "input": 1,
    "output": 2,
    "cacheRead": 0.1,
    "cacheWrite": 0.2,
    "context": 64000,
    "maxOutput": 8192,
    "modalities": [
      "テキスト",
      "画像"
    ],
    "reasoning": false,
    "free": false,
    "batchOff": null,
    "tierCount": 0,
    "tierFrom": null,
    "tierOutput": null,
    "timedCount": 2,
    "sourceUrl": "https://api-docs.deepseek.com",
    "updatedAt": "2026-10-07"
  }
]

GET /api/vendors

ベンダー一覧(件数とロゴパス付き)

レスポンス例

{
  "ok": true,
  "count": 17,
  "data": [
    {
      "name": "DeepSeek",
      "count": 2,
      "logo": "/logos/deepseek.png"
    },
    {
      "name": "OpenAI",
      "count": 29,
      "logo": "/logos/openai.png"
    }
  ]
}

GET /api/categories

カテゴリ一覧(件数付き)

レスポンス例

{
  "ok": true,
  "count": 7,
  "data": [
    {
      "name": "会話",
      "count": 79
    },
    {
      "name": "動画生成",
      "count": 27
    }
  ]
}

GET /api/changes

価格変動ログ(日付降順)

レスポンス例

{
  "ok": true,
  "count": 1,
  "data": [
    {
      "date": "2026-09-04",
      "title": "建站首轮全量核对(28 个模型 / 10 家厂商)",
      "tag": "基线",
      "items": [
        "DeepSeek 官方文档直采:V4-Flash 输入 3 / 输出 9(高峰,空闲半价)"
      ]
    }
  ]
}

rate-limit

レート制限

各クライアントのデフォルト制限: 1 分あたり最大 50 リクエスト (60 秒スライディングウィンドウ)。2 つの軸で独立にカウントされ、どちらかを超えると拒否されます:

IP バケット — クライアント IP(Cloudflare 経由の場合 CF-Connecting-IP、それ以外は接続アドレス / XFF)
リクエストフィンガープリントバケット — IP + User-Agent + Accept-Language + Accept + Sec-CH-UA のハッシュ。UA やヘッダーを変えても IP 制限は回避できません

制限超過時は 429 Too Many Requests, を返します。レスポンスには Retry-After(秒)と X-RateLimit-* ヘッダーが付き、通常レスポンスにも X-RateLimit-Limit / Remaining / Reset,が含まれるため、クライアント側のバックオフにご利用ください。

429 响应示例

HTTP/1.1 429 Too Many Requests
Retry-After: 37
X-RateLimit-Limit: 50
X-RateLimit-Remaining: 0

{
  "ok": false,
  "error": "rate limit exceeded: max 50 requests / 60s (per IP and request fingerprint), retry later"
}

errors

エラー規約

失敗レスポンスは常に { ok: false, error: "message" }, の形式で、適切な HTTP ステータスコードとともに返ります:

404 — model not found: xxx(slug が存在しない)

429 — rate limit exceeded: …(レート制限)

500 — サーバー内部エラー

mcp

MCP Server(Agent 向け)

Claude / Cursor などの Agent に取り込むには、MCP に直接接続できます: https://mcp.pricemon.net/mcp (Streamable HTTP)。ツールは search_models、 get_model_price、 compare_prices、 list_changes など。詳しくはリポジトリの

← マーケットへ戻る · 価格変更ログ →