Claude Opus 5 API: 호출 방법, 비용, 그리고 과한 경우

The Claude Opus 5 API is live on the Messages endpoint and on every OpenAI-compatible gateway that carries it. To call it directly you POST to https://api.anthropic.com/v1/messages with the model id claude-opus-5 and the anthropic-version: 2023-06-01 header. To call it with an OpenAI-style client — the route that needs no new SDK — you point your base URL at https://api.orcarouter.ai/v1 and pass the model id anthropic/claude-opus-5, which is how OrcaRouter exposes it. The price is identical on both: $5 per million input tokens and $25 per million output, exactly the list rate with zero markup. It launched on July 24, 2026, and it is the current Opus tier — Claude Opus 4.8 costs the same $5 / $25 and scores lower on the independent benchmarks. The interesting decision is not which dialect to use; it is whether Opus-tier is what your workload actually needs.

두 개의 엔드포인트, 하나의 모델

Claude Opus 5 API에 대한 대부분의 튜토리얼은 네이티브 Anthropic 호출만 보여주고 거기서 멈춥니다. 실제로는 두 가지 방식이 있으며, 둘 다 동일한 가중치에 도달합니다.

• Anthropic native — /v1/messages. POST to https://api.anthropic.com/v1/messages with two required headers: x-api-key with your key and anthropic-version: 2023-06-01. The body carries model: "claude-opus-5", a max_tokens, and a messages array. This is what the Anthropic Python and TypeScript SDKs send under the hood.

• OpenAI-compatible — /v1/chat/completions. POST to https://api.orcarouter.ai/v1/chat/completions (or /v1/messages if you want the Anthropic dialect through the same host) with the model id anthropic/claude-opus-5. If you already run an OpenAI client, the switch is two lines: change base_url to https://api.orcarouter.ai/v1 and swap the API key. Nothing else in your request shape changes.

• 클라우드 모델. Amazon Bedrock에서 ID는 anthropic.claude-opus-5이고, Google Vertex AI 및 Microsoft Foundry에서는 자사 ID인 claude-opus-5를 유지합니다. 이러한 경로는 이미 클라우드 제공업체를 선택한 팀을 위한 것이며, OpenAI 호환 경로가 코드를 이식 가능하게 유지해 줍니다.

모델은 어떤 방언을 사용하는지 신경 쓰지 않습니다. 달라지는 것은 호출 주변의 모든 것입니다 — 결제, 키, 속도 제한, 장애 조치, 그리고 코드를 변경하지 않고 도달할 수 있는 다른 모델의 개수입니다.

당신이 얻는 것 — 그리고 기존 코드를 깨뜨리는 두 가지

Claude Opus 5는 Anthropic의 추론 중심 플래그십 모델로, 100만 토큰 컨텍스트 윈도우(최대치가 곧 기본값), 128K 출력 상한, 2026년 5월 지식 컷오프, 텍스트·이미지·파일 입력과 텍스트 출력을 갖추고 있습니다. 독립적인 Artificial Analysis 리더보드에서 측정 결과 AA Coding 78.0(132개 모델 중 1위), 그리고 AA Intelligence 63.1(134개 모델 중 2위)를 기록했으며, 2026년 7월 24일 기준 GPQA Diamond 93.2, Humanity's Last Exam 점수 54.9도 나타냈습니다. Anthropic의 자체 출시 성능 주장(Frontier-Bench에서 Opus 4.8의 약 2배)은 공급업체가 실행한 결과이며 독립적으로 재현되지 않았습니다.

추론은 기본적으로 켜져 있습니다. 적응형 추론은 각 호출에서 추론할 양을 결정하며, output_config.effort 매개변수에 의해 제어됩니다. 이 매개변수는 low부터 max까지 허용하며 기본값은 high입니다. 코딩 및 에이전틱 루프의 경우, xhigh가 권장 시작점입니다. low와 medium은 이전 모델보다 Opus 5에서 확실히 더 강력하므로, 장난감 호출이 아닌 실제 워크로드에 사용할 수 있습니다. 추론 토큰은 출력 비용에 포함됩니다.

Claude Opus 4.8의 두 가지 주요 변경 사항은 이전 요청 본문을 복사하는 모든 사용자에게 문제를 일으킵니다:

• 이제 max_tokens 값이 타이트하면 응답이 잘립니다. 추론(thinking)이 기본적으로 실행되므로, 예상 답변 길이에 맞춰 설정된 max_tokens는 먼저 추론에 소모됩니다. 4.8 워크로드를 변경 없이 그대로 옮기면, 상한을 올리거나 추론 노력을 낮추기 전까지는 잘린 응답이 발생할 것으로 예상하세요.

• 샘플링 파라미터는 거부됩니다. temperature, top_p, 및 top_k가 기본값이 아닌 값이면 400 오류를 반환하며, assistant prefill도 마찬가지입니다. 출력 제어는 effort로 하세요, temperature가 아니라.

• Thinking 비활성화에는 상한이 있습니다. thinking: {"type": "disabled"}는 effort high 이하에서만 허용되며, 이를 xhigh 또는 max와 함께 사용하면 400이 반환됩니다. 비용을 절감하는 합리적인 방법은 thinking을 끄는 것이 아니라 effort를 낮추는 것입니다.

실제 드는 비용

Claude Opus 5의 가격은 입력 토큰 100만 개당 $5, 출력 토큰 100만 개당 $25 — 이는 Claude Opus 4.8과 동일한 가격으로, 이번 출시에서 조용히 반가운 소식입니다. 캐시 읽기는 100만 개당 $0.50 (프롬프트 캐싱에는 최소 512토큰 프리픽스가 필요하며 5분 및 1시간 TTL을 지원합니다). 리서치 프리뷰 고속 모드는 동일한 모델을 초당 최대 2.5배의 출력 토큰으로 실행하며, 가격은 $10 / $50, 그리고 Batch API는 결과를 비동기적으로 반환하며 반값입니다.

구체적인 인보이스를 보자면, 100K 토큰 요청이 20K 출력 토큰을 생성할 때 청구되는 금액은입력 $0.50, 출력 $0.50, 총 $1.00이며, 캐시되지 않은 경우입니다. 만약 그 100K 프롬프트가 다음 호출에서 캐시로 제공되면 입력 비용은 약 $0.05로 떨어져, 총 $0.55의 왕복 비용이 됩니다. 이 캐시 계산이 Opus를 길고 반복적인 컨텍스트에서 저렴하게 사용할 수 있게 하는지, 아니면 전혀 사용할 수 없게 하는지를 결정합니다.

규모를 가늠하기 위한 위와 아래 등급: Claude Fable 5는 Anthropic의 최고 성능 모델로, 가격은 $10 / $50이며 Claude Sonnet 5는 $3 / $15 ($2 / $10의 도입 가격이 2026년 8월 31일까지 적용됩니다); Claude Haiku 4.5는 $1 / $5. OrcaRouter에서는 이 모든 모델이 공급업체의 정가 그대로 전달되며 토큰당 마크업이 없으므로, 위의 비교가 곧 실제 지불 금액입니다.

단일 엔드포인트의 경우

Claude Opus 5 API 가이드를 읽고 있다면, 아마 이미 연동과 키를 보유하고 있을 것입니다. 실제 질문은 다음에 시도할 모델을 위해 두 번째 연동과 두 번째 키를 원하는지 여부입니다. OrcaRouter는 하나의 OpenAI 호환 엔드포인트를 200개 이상의 모델 앞에 두는 방식으로 이에 답합니다. 즉, 동일한 클라이언트와 동일한 base URL을 사용하되, 모델별로 model id만 다르게 지정하는 것입니다 — anthropic/claude-opus-5는 오늘 사용하고, 워크로드가 더 이상 Opus 등급을 요구하지 않게 되면 더 저렴한 모델로, 새 모델이 출시되는 주에는 새로운 프론티어 모델로, 코드 변경 없이 전환하면 됩니다.

경제성은 정직한 부분입니다. OrcaRouter의 추가 비용은 토큰당 $0입니다. 즉, 각 제공업체의 공개 요금을 지불하므로 Claude Opus 5는 Anthropic의 $5/$25를 유지하고, 공급업체의 가격 인하는 발표 당일 저희 쪽에 바로 반영됩니다. 자체 키 가져오기는 일급 옵션입니다. 기존 Anthropic API 키를 넘기면 자체 속도 제한과 크레딧이 유지되고, 제공업체가 직접 청구합니다. 가드레일(PII 차폐 및 콘텐츠 정책)은 요청이 청구되기 전에 적용되며, 이후가 아닙니다. anthropic/claude-opus-5의 모델 페이지에는 실시간 가격, 1M 컨텍스트, 현재 처리량 수치가 표시되며, 라우팅 DSL은 Opus 5가 오류를 일으키거나 트래픽 형태가 허용할 때 더 저렴한 모델이 응답하도록 페일오버를 구성합니다.

Opus 5가 정답이 아닌 경우

최고라는 것이 곧 작업량에 적합하다는 뜻은 아닙니다. $5 / $25 플래그십이 뒤처지는 부분은 세 군데입니다.

• 대용량이면서 위험 부담이 낮은 호출. 월 1,000만 개의 입력 토큰을 처리하는 요약 또는 분류 파이프라인은 Claude Opus 5에서 $50인 반면, Claude Haiku 4.5에서는 $10입니다. 동일한 엔드포인트, 동일한 키, 아이디 하나만 바꾸면 됩니다. Haiku는 Opus만큼 강력하지는 않지만, 라우팅, 추출, 서식 작업에는 5배 비용 차이를 정당화하기 어려울 만큼 충분히 가깝습니다.

• 긴 에이전트 루프.Opus 5는 요청 없이도 자체적으로 작업을 검증하므로, 이전 모델에 맞춰 조정된 "답을 다시 확인하세요" 지시가 과도한 검증을 촉발하고 추론 토큰을 소모합니다. xhigh 및 max effort에서는 설계상 추론 예산이 증가합니다. 에이전트에 최첨단 추론이 필요하지 않다면, $3 / $15의 Claude Sonnet 5가 대부분의 프로덕션 팀이 시작해야 할 기본값이며, effort 다이얼로 이를 낮춰 조정하면 됩니다.

• 모델이 우리 것이 아닌 경우. OrcaRouter는 라우팅과 청구를 처리하고, Anthropic이 가중치를 운영합니다. 엔드포인트, 무마크업, 장애 조치, 안전장치는 우리 것이지만, 추론 품질과 안전 동작은 Anthropic의 것입니다. 그리고 BYOK를 사용하면 비용은 그들에게 직접 전달됩니다. 간단히 말해 조건은 이렇습니다: 어느 쪽이든 제공업체 요금을 지불하며, 문제는 200개 이상의 모델을 위한 하나의 엔드포인트가 가치 있는지 여부입니다.

결론

다른 통합이 없다면 네이티브 Messages 엔드포인트로 Claude Opus 5 API를 호출하고, 모든 것을 위한 단일 클라이언트를 원한다면 OpenAI 호환 엔드포인트로 호출하세요. 이 모델은 작업이 어렵고, 컨텍스트가 길며, 출력이 토큰 100만 개당 25달러의 가치가 있을 때 적합한 모델입니다. 반면 일상적인 작업에는 적합하지 않습니다. 가장 깔끔한 설정은 마음을 바꿀 수 있게 해주는 설정입니다. 즉, 하나의 엔드포인트, 자신의 키, $0 마크업, 그리고 워크로드가 바뀌는 날 교체할 수 있는 모델 ID입니다.