API · MCP

API 와 MCP

AI 모델 변경 피드를 에이전트나 서비스에서 직접 받아갑니다.

무엇을 주는가

벤더 릴리스 노트, Hugging Face 업로드, OpenRouter 카탈로그, GitHub 를 하나로 정규화한 변경 피드입니다. 같은 모델의 중복은 합쳤고, 각 항목에 공식 출처인지 검수 대기인지 표시했습니다. 가격과 컨텍스트는 OpenRouter 공개 카탈로그에서 옵니다. 그것만 필요하다면 원본을 직접 부르는 편이 낫습니다.

기계가 읽는 형식

도구와 에이전트는 산문이 아니라 스키마를 읽습니다. 아래 두 곳을 먼저 보세요.

키 발급

로그인 후 내 알림 화면에서 발급합니다. 키는 발급 순간에만 보이고 저장은 해시만 합니다.

키 만들러 가기

REST 엔드포인트

# 마지막으로 받은 뒤 바뀐 것만
curl -H "Authorization: Bearer $AIWAVE_KEY" \
  "https://aiwave.elopstudio.com/api/v1/changes?since=1789023600"

# 조건에 맞는 모델
curl -H "Authorization: Bearer $AIWAVE_KEY" \
  "https://aiwave.elopstudio.com/api/v1/models?maxInputPrice=1&minContext=200000"

토큰 견적

쓰는 만큼 얼마인지 모델별로 계산해 돌려줍니다. 단가표만으로도 곱셈은 할 수 있지만 토큰 세기가 남습니다 — 벤더마다 토크나이저가 다르고, 한국어는 영어 기준 계산기와 크게 어긋납니다. tokens 를 주면 그 값으로 곱하고, text 를 주면 o200k 기준으로 어림잡습니다(문단 길이에서 토큰 가중 오차 7.6%). 둘 다 주면 tokens 가 이깁니다.

curl -X POST -H "Authorization: Bearer $AIWAVE_KEY" \
  -H "Content-Type: application/json" \
  "https://aiwave.elopstudio.com/api/v1/estimate" -d '{
    "input":  { "text": "이 문서를 세 문장으로 요약해 주세요." },
    "output": { "tokens": 500 },
    "calls":  1000,
    "models": ["openai/gpt-5.2", "anthropic/claude-opus-4.6"]
  }'

보낸 글은 저장하지 않습니다. 세고 버립니다. 애초에 보내고 싶지 않다면 tokens 로 숫자만 주세요 — 입력 토큰을 정확히 세야 한다면 gpt-tokenizer 같은 패키지로 오프라인 계산해서 그 값을 넘기는 편이 낫습니다. 왕복이 하나 줄고 우리 추정보다 정확합니다. 결과마다 costSplit 으로 비용이 입력·출력 중 어디서 나오는지 함께 줍니다. 출력 비중이 크다면 총액의 불확실성은 토큰 세기가 아니라 답 길이에 있습니다 — 출력은 아직 쓰이지 않은 글이라 아무도 못 셉니다. 캐시·배치 할인과 구간 요금은 반영하지 않으므로 실제 청구액은 이보다 낮을 수 있습니다.

폴링

since 에 마지막으로 받은 latest 를 넣으면 그 뒤에 바뀐 것만 오래된 순으로 옵니다. 놓치는 항목 없이 이어받을 수 있습니다.

{
  "items": [ { "type": "deprecation", "title": "...", "detectedAt": "..." } ],
  "latest": 1789023600
}

MCP (원격)

설치 없이 URL 과 키만 넣으면 됩니다. Claude Code 나 MCP 를 지원하는 클라이언트의 설정에 아래를 넣으세요.

{
  "mcpServers": {
    "ai-wave": {
      "type": "http",
      "url": "https://aiwave.elopstudio.com/api/mcp",
      "headers": { "Authorization": "Bearer aiw_live_..." }
    }
  }
}

MCP (로컬 실행)

사내망처럼 원격을 못 쓰는 환경에서는 npx 로 로컬 실행합니다.

{
  "mcpServers": {
    "ai-wave": {
      "command": "npx",
      "args": ["-y", "@elopstudio/ai-wave-mcp"],
      "env": { "AIWAVE_API_KEY": "aiw_live_..." }
    }
  }
}

도구

list_model_changes(since?, type?, model?, limit?)
  새 모델·가격 변경·API 변경·지원 종료. since 로 폴링한다.

get_model(id)
  OpenRouter ID 나 Hugging Face ID 로 가격·컨텍스트·카탈로그 상태.

search_models(vendor?, maxInputPrice?, minContext?, limit?)
  조건에 맞는 모델을 주목도 순으로.

한도

무료 등급은 하루 1,000회입니다. 응답 헤더로 남은 횟수를 알려줍니다. 더 필요하시면 문의해 주세요. 지금은 수동으로 올려 드립니다.

x-ratelimit-limit: 1000
x-ratelimit-remaining: 991
x-aiwave-tier: free