25분
Request와 Response 읽기
Day 2: API 문서 읽기
Request와 Response 읽기
영어 문서 독해: API 문서, GitHub, Stack Overflow > Day 2: API 문서 읽기
학습 목표
API 문서의 Request 섹션을 읽을 수 있다 Required와 Optional 파라미터를 구분할 수 있다 Response 구조를 이해할 수 있다
Request 읽기
OpenAI Chat Completions API 문서를 읽어보자.
에디터 로딩 중...
핵심 패턴:
| 용어 | 의미 |
|---|---|
| Required | 필수. 없으면 에러 |
| Optional | 선택. 없어도 됨 |
| Defaults to X | 기본값은 X |
| string | 문자열 |
| integer/number | 숫자 |
| array | 배열/리스트 |
| object | 객체/딕셔너리 |
실제 요청 예시
에디터 로딩 중...
Required인 model, messages는 반드시 있어야 한다. Optional인 temperature, max_tokens는 생략 가능.
Response 읽기
에디터 로딩 중...
핵심 필드:
choices[0].message.content- AI 응답 내용usage.total_tokens- 사용한 토큰 수 (비용 계산용)
Python에서 Response 사용
에디터 로딩 중...
API 문서의 Response 구조를 알면, 어떤 필드에 접근해야 하는지 바로 알 수 있다.