빠른 답변
- 복잡하고 장기간에 걸친 코딩 작업과 고부가가치 엔지니어링 워크플로를 위해 설계되었습니다.
- 지시 준수력과 일관성이 뛰어나 엄격한 납품 요건에도 적합합니다.
- 이미지 이해, 도구 호출, 스트리밍을 지원해 실용적인 멀티모달 파이프라인을 구성할 수 있습니다.
주요 파라미터
- model | string | 필수 | claude-opus-4-6 | - | 이 페이지의 모델 식별자입니다(예: claude-opus-4-6).
- messages | object[] | 필수 | - | - | 대화 메시지를 시간 순서대로 지정합니다. role 은 user 와 assistant 를 지원합니다.
- max_tokens | integer | 필수 | - | >=1 | 출력 토큰의 최댓값입니다.
- system | string | object[] | 선택 | - | - | 최상위 system 프롬프트입니다(messages 안에 넣지 마세요).
- stream | boolean | 선택 | false | - | SSE 스트리밍 출력 여부를 지정합니다.
- temperature | number | 선택 | 1 | 0-1 | 출력의 무작위성을 제어하는 샘플링 온도입니다.
- top_p | number | 선택 | - | 0-1 | 뉴클리어스 샘플링 임계값입니다. temperature 와 동시에 크게 조정하지 마세요.
- stop_sequences | string[] | 선택 | - | - | 지정한 문자열이 일치하면 생성을 중단하는 중지 시퀀스입니다.
- Authorization | HTTP Header | 선택 | - | - | Bearer 인증입니다: Authorization: Bearer <YOUR_API_KEY>.
- x-api-key | HTTP Header | 선택 | - | - | API 키 인증입니다(Anthropic SDK 에서 흔히 사용). Authorization 중 하나만 사용합니다.
- anthropic-version | HTTP Header | 선택 | 2023-06-01 | - | Anthropic API 버전 헤더입니다. 보통 Anthropic SDK 가 자동으로 설정합니다.
자주 발생하는 오류
- 400 invalid_request_error: 발생 조건=필수 필드 누락, messages 스키마 오류, 파라미터 타입 불일치.; 해결=model, messages, max_tokens 필드와 데이터 타입을 확인합니다.; 재시도=요청 본문을 수정한 뒤 재시도합니다.
- 401 authentication_error: 발생 조건=Authorization 헤더 누락, 형식 오류 또는 유효하지 않은 키입니다.; 해결=Bearer 토큰 형식과 키 권한을 확인합니다.; 재시도=인증을 수정한 뒤 재시도합니다.
- 429 rate_limit_exceeded: 발생 조건=요청 빈도, 동시성 또는 현재 할당량이 상위 서비스의 레이트 리밋에 도달했습니다.; 해결=먼저 지수 백오프로 재시도하고, 이후 요청 빈도, 동시성, 할당량 사용량을 확인합니다.; 재시도=1s/2s/4s 백오프에 지터를 더해 사용하고, 계속되면 전송 빈도를 낮춥니다.










