OpenAI Python SDK에서 URL에 쿼리 값을 더하려면 어떻게 하나요? 초보자 extra_query 사용법

질문

OpenAI Python SDK에서 URL에 쿼리 값을 더하려면 어떻게 하나요?

답변

공식 Python SDK에서는 호출의 extra_query 에 이름·값의 딕셔너리를 넣어 URL 쿼리 매개변수를 추가합니다. JSON 본문을 더하는 extra_body 나 HTTP 헤더를 더하는 extra_headers 와 전달 위치가 다릅니다.

먼저 해당 API가 그 쿼리 이름과 값을 받는지 확인하세요. SDK에 전달할 수 있다는 사실만으로 서버에 새 기능이 생기지는 않습니다. 이미 공식 인수가 있으면 그 인수를 먼저 쓰는 편이 명확합니다.

API의 쿼리 지원 확인 → 기존 인수 대조 → extra_query에 추가 → 실제 URL과 결과 확인 순서입니다. 이 글은 요청 옵션을 어디에 넣는지 설명하며 파일 정리나 모델 답변 생성 절차와는 구분합니다.

예를 들어 파일 목록 API의 공식 쿼리 옵션을 확인했는데 사용하는 SDK의 호출 인수에서 찾기 어렵다고 해 보세요. 임의의 새 인수 이름을 붙이기 전에 실행 버전과 공식 문서를 대조합니다. 서버가 지원하는 값인지가 우선입니다.

Python API library의 추가 요청 옵션 안내는 extra_query · extra_body · extra_headers 를 구분합니다. Files의 list 구현도 extra_query를 별도 인수로 받고 쿼리 설정에 합칩니다. 본문에 같은 이름을 적는 것으로 대신하지 않습니다.

공식 SDK 구현에서는 메서드의 일반 쿼리와 extra_query를 합칠 때 같은 이름의 추가 값이 우선합니다. 그래서 limit=10 과 extra_query={"limit": 1} 을 함께 넣으면 원래 limit 의도를 바꿀 수 있습니다. 같은 옵션을 두 곳에 중복 지정하지 마세요.

한 줄 정리: 전달할 위치와 서버의 지원 조건을 함께 확인하세요. 쿼리로 보내야 할 값을 헤더·본문·질문 문장에 넣지 않습니다.

• 요청 한 건에 HTTP 헤더를 어떻게 추가하나요?
• 올린 파일은 어떻게 확인하고 지우나요?
• API 엔드포인트란 무엇인가요?