Raw HTTP는 SDK나 래퍼 없이 HTTP 프로토콜 그대로 요청을 조립해서 보내는 방식입니다. curl, requests, fetch 같은 도구로 메소드·URL·헤더·바디를 직접 세팅하는 거라, API가 실제로 어떻게 동작하는지 투명하게 보입니다.

LLM API를 처음 배울 때 Raw HTTP로 한 번 찍어보면 이해가 빨라집니다. “Authorization 헤더에 API 키가 들어가고, JSON body에 messages 배열이 있고, 응답은 JSON 또는 SSE 스트림이다” 같은 구조가 한눈에 들어오니까요.

실서비스에서는 SDK가 재시도·타입·스트리밍 처리를 대신해줘서 편하지만, 디버깅·네트워크 분석·타 언어 포팅이 필요한 순간에는 Raw HTTP로 돌아가 확인하는 게 가장 확실합니다.

curl 예제와 구조 분해는 P2. API로 LLM 호출이란 기사에 정리했어요.

→ 1차 소스: Anthropic · Messages API (curl examples)