Anthropic Claude Sonnet 5.5 기반의 OpenAI 호환 채팅 완성 API입니다. Sonnet 라인의 최신 모델로 속도와 지능의 최적 조합이며, 100만 토큰 컨텍스트, 요청당 최대 128K 토큰 출력, 적응형 사고를 갖췄습니다. 이미지 입력, 도구 호출, 프롬프트 캐싱, stop, 스트리밍을 지원하며 model을 claude-sonnet-5-5로 지정하면 됩니다. OpenAI 호환 엔드포인트에서는 기본 강도로 생각하고 사고 내용을 반환하지 않으며 response_format 적용은 보장되지 않습니다. 사고 강도(output_config.effort: low / medium / high / xhigh / max), 사고 요약(thinking.display: summarized), 구조화 출력(output_config.format), PDF 입력이 필요하면 네이티브 Anthropic Messages API /anthropic/v1/messages를 사용하세요. Claude Code를 바로 연결할 수 있습니다. temperature / top_p / top_k는 무시되고 도구 강제 호출은 auto로 처리하며 thinking을 disabled로 보내면 무시됩니다.
📥 컨텍스트 창 (최대 입력):1,000,000 토큰(100만, Anthropic 공개 수치). 요청당 최대 128,000 토큰까지 출력합니다.
플레이그라운드에서 사용해 보기 →인증
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
콘솔에서 API 키를 만들면 시작할 수 있습니다.
요청 본문
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
| model | string | 예 | 모델 ID. 여기서는 claude-sonnet-5-5입니다. |
| messages | array | 예 | 메시지 배열. 각 항목은 role(system/user/assistant)과 content를 가집니다. content는 문자열이거나, 이미지 이해(멀티모달 / 비전)를 위한 {type:text}와 {type:image_url} 조각들의 배열일 수 있습니다. |
| stream | boolean | 아니오 | SSE로 스트리밍할지 여부. 기본값 false. |
| temperature | number | 아니오 | 효과 없음: 이 모델은 temperature / top_p를 무시하며(오류 없음) 기본 샘플링으로 동작합니다. |
| max_tokens | integer | 아니오 | 생성할 최대 토큰 수. |
| web_search | boolean | 아니오 | true로 두면 웹 검색이 켜집니다. 게이트웨이가 모델이 답하기 전에 실시간 검색 결과로 프롬프트를 보강하고 출처를 함께 제시합니다. tools 항목 {"type":"web_search"}로도 켤 수 있습니다. |
| reasoning_effort | string | 아니오 | OpenAI 호환 엔드포인트에서는 효과가 없으며 모델은 기본 강도로 생각합니다. 사고 강도를 지정하려면 네이티브 Anthropic API에서 output_config.effort(low / medium / high / xhigh / max)를 보내세요. |
요청 예시
curl https://nezhagate.com/v1/chat/completions -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model": "claude-sonnet-5-5", "messages": [{"role": "user", "content": "Hello"}], "stream": false}'응답
{
"id": "chatcmpl_xxx",
"object": "chat.completion",
"model": "claude-sonnet-5-5",
"choices": [
{"index": 0, "message": {"role": "assistant", "content": "Hello!"}, "finish_reason": "stop"}
],
"usage": {"prompt_tokens": 11, "completion_tokens": 7, "total_tokens": 18}
}이미지 입력 (Vision)
메시지 content 배열에 이미지를 넣으면 모델이 이를 분석합니다(시각적 질의응답, 텍스트 판독 / OCR 등). image_url에는 공개 이미지 링크 또는 인라인 base64 data URL(data:image/png;base64,...)을 넣을 수 있습니다. 멀티모달 모델(gpt-5.5, gemini 계열 등)에서 사용할 수 있습니다.
curl https://nezhagate.com/v1/chat/completions -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model": "claude-sonnet-5-5", "messages": [{"role": "user", "content": [{"type": "text", "text": "이 사진에는 무엇이 있나요?"}, {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}}]}]}'오류 코드
모든 오류 본문에는 error.message / error.type / error.code / error.param이 들어 있습니다. 분기는 code로 하세요. 전체 목록은 연동 가이드에 있습니다.
| HTTP | code | 설명 |
|---|---|---|
| 401 | invalid_api_key | API 키가 없거나 유효하지 않음 |
| 402 | insufficient_quota | 잔액 부족 또는 키 한도 초과 |
| 400 | invalid_request | 지원하지 않는 모델 또는 파라미터 |
| 429 | rate_limit_exceeded | 업스트림 요청 한도 초과 |
| 502 | upstream_error | 모든 업스트림 경로가 실패 |