/ 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[] bare array;?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": "백만 토큰",
      "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": "백만 토큰",
    "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[] bare array;?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": "백만 토큰",
    "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

요청 제한

각 클라이언트 기본 제한: 분당 최대 50 요청 (60초 슬라이딩 윈도우). 두 축 각각 독립적으로 집계되며 하나라도 초과하면 거부됩니다:

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 등. 자세한 내용은 저장소의

← 마켓으로 돌아가기 · 가격 변경 로그 →