소개
Claude Opus 4.6는 Anthropic의 Opus 계열 채팅 모델로, 여기서는 /v1/chat/completions의 OpenAI 호환 엔드포인트 하나로 제공합니다. 요청마다 최대 1,000,000토큰을 읽고 응답 하나로 최대 128,000토큰을 쓸 수 있어, 긴 공동 작업을 통째로 넘기고 한 챕터를 한 번에 받을 수 있습니다.
추론 강도는 low, medium, high, max 네 단계이며 기본값은 medium이고, temperature(0~1)와 top_p도 조정할 수 있습니다. 메시지 내용은 텍스트와 이미지를 받으며, 같은 호출에서 도구 최대 128개와 SSE 스트리밍을 쓸 수 있습니다.
핵심 기능 및 하이라이트
max를 포함한 네 단계의 추론 강도
max는 high보다 한 단계 위로, 심어 둔 디테일과 타임라인, 긴 확정 사실 목록을 한 글자라도 쓰기 전에 모두 맞춰야 하는 요청을 위한 단계입니다. 추론은 출력 토큰으로 소비되므로 평소 턴은 low나 medium에 두고, max는 그만한 가치가 있는 작업에만 쓰세요.
입력 1,000,000토큰, 출력 128,000토큰
읽는 양이 쓰는 양의 약 여덟 배입니다. 원고 전체와 스타일 가이드, 이전 세션의 메모까지 요청 하나에 들어가고, 응답 상한도 충분히 높아 한 챕터를 쪼갰다가 다시 이을 필요가 없습니다.
temperature와 top_p는 직접 조정
추론 강도와 함께 temperature 01, 1을 받습니다. 모델이나 엔드포인트를 바꾸지 않고도 연속성 점검은 낮은 온도로 재현 가능하게, 아이디어를 내는 턴은 높은 온도로 돌릴 수 있습니다.top_p 0.01
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
messages | 예 | 순서대로 놓인 대화 턴입니다. 내용은 문자열이거나 text와 |
max_tokens | 아니요 | 응답을 128,000에서 자릅니다. 읽기 창의 8분의 1이고, 기본값은 4,096입니다. |
reasoning_effort | 아니요 | low, medium, high, max이고 기본은 medium입니다. 모델이 쓰기 전에 세부를 맞춰야 하는 답이면 올리세요. |
stop | 아니요 | 최대 4개의 정지 시퀀스를 문자열 또는 배열로 지정합니다. 모델이 그중 하나를 쓰는 즉시 응답이 끝나며, 일치한 텍스트 자체는 반환되지 않습니다. 1자 이상 · 1개 이상 · 4개 이하 |
temperature | 아니요 | 0에서 1까지, 기본값은 1입니다. 응답을 코드가 파싱한다면 0으로 고정하고, 한 작품의 목소리가 정해졌으면 그대로 두세요. |
top_p | 아니요 | 0.01에서 1까지입니다. 한 비교 안에서는 이 값이나 temperature 중 하나만 조절하세요. |
tools | 아니요 | 요청당 함수 정의 최대 128개입니다. 128개 이하 |
parallel_tool_calls | 아니요 | true 또는 false이며 기본값은 true입니다. true이면 모델이 한 턴에 여러 도구 호출을 요청할 수 있습니다. 기본값: |
tool_choice | 아니요 | auto, none, required, 또는 함수 하나를 지정한 객체입니다. |
요금
입력 $5 / 출력 $25 100만 토큰당
활용 사례
원고 한 권 규모의 편집
초고 전체와 스타일 가이드를 보내고 한 챕터의 문장 단위 교정을 요청하되, 수정마다 가이드에 비춘 이유를 달게 하세요. 모델은 교정 중인 챕터만이 아니라 책 전체에서 각 인물이 어떻게 말하는지 봅니다.
긴 공동 창작 픽션
함께 쓰는 이야기 수백 턴을 요약 단계 없이 매 요청에 다시 보낼 수 있습니다. 초반에 한 약속도 이야기가 마침내 그것을 필요로 할 때 원래 표현 그대로 읽힙니다.
max로 한 번만 꼼꼼하게
타임라인과 인물 관계망, 풀리지 않은 복선 목록을 한 응답에서 맞춰야 할 때는 그 요청만 max로 보내고 max_tokens를 한 챕터 분량으로 잡습니다. 그다음 평소 턴은 다시 medium으로 돌아갑니다.
프롬프트 가이드 및 실전 팁
추론 강도는 세션이 아니라 턴에 맞추세요
대부분의 턴은 오래 고민할 필요가 없습니다. 기본값 medium을 두고, 빠른 주고받기에는 low로 낮추며, 복선을 묶는 턴에서만 high나 max로 올리세요. 같은 요청 본문의 문자열 하나만 바꾸면 됩니다.
원하는 응답에 맞춰 max_tokens를 정하세요
기본값은 4,096토큰이고, 한 챕터에는 훨씬 더 많이 필요합니다. 추론 토큰도 출력으로 과금되므로 눈에 보이는 응답보다 여유를 두고, 최대 128,000 안에서 설정하세요.
알아 둘 한계
128,000을 넘는 max_tokens는 검증에서 거부되고 동영상 및 오디오 파트도 받지 않습니다. 응답을 미리 채우려고 assistant 메시지로 대화를 끝낼 수 없고 response_format도 없습니다. 구조화 출력은 JSON 스키마를 매개변수로 삼은 도구를 tool_choice로 강제해 받습니다.
API 빠른 시작
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "anthropic/claude-opus-4.6/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.














